Super cute front-end and back-end separated blog Mix-space setup

The blog version is only a supplementary explanation for the video version, details can be found in the documentation!

The changes in mx are too significant, so everyone can just use it for reference; too many things have changed.

Excerpt from https://github.com/mx-space/docs documentation repository, the order is slightly different, following my video method is the optimal solution.

Documentation address https://mx-space.js.org

Video Usage:

BGM:

Summer Madness-Roa

moonlight-Roa

Lights-Sappheiros

Embrace-Sappheiros

Introduction#

A new way to replace personal space

An open-source Mix-Space blog developed by a big shot innei as part of their undergraduate graduation project, adopting a front-end and back-end separation model.

Mix-Space separates the front-end and back-end, meaning you can deploy them on different servers separately, or you can deploy everything on a single server.

The Core of Mix-Space provides back-end service support, Kami is the front-end that the author updates most frequently, and Mx-Yun is a ported version of Cloud Traveler's Hexo-Yun; of course, Kami provides the most comprehensive support, enjoying all the features of Core, with good animations and various cute little Easter eggs!

This time we deploy the most complete Kami front-end.

Preparation#

You need to prepare a server to run Mix-space.

A brain that can think critically
Linux kernel version > 4.18 (recommended to use the latest version of Ubuntu)
Running memory > 1GiB
SSL certificates for both front-end and back-end
Properly resolved front-end and back-end addresses
Baota panel

Optional:

Ubuntu with Docker images (or Tencent Cloud application image Docker)

In the Baota panel - Software Store - Runtime Environment, install PM2 Manager and Nginx, install the latest Node version, this chapter installs v16.15.1.

At least Node > 16.X

Debian / Ubuntu install dependency environment

sudo apt update && sudo apt install git curl vim wget git-lfs -y

Install dependency environment#

sudo su
npm install -g pnpm pm2

# If the installation is slow, you can use the following command to switch the mirror source
npm config set registry http://mirrors.cloud.tencent.com/npm/

Install Docker#

sudo curl -fsSL https://get.docker.com | bash -s docker

# If the installation is slow, it is recommended to use the following command
sudo curl -fsSL https://get.docker.com | bash -s docker --mirror Aliyun

Install Docker-compose#

# Download docker-compose

wget https://github.com/docker/compose/releases/download/v2.6.0/docker-compose-linux-x86_64

#(Alternative) wget https://download.fastgit.org/docker/compose/releases/download/v2.6.0/docker-compose-linux-x86_64

# Create a folder (not mandatory), may be needed

sudo mkdir -p /usr/local/lib/docker/cli-plugins/

# Copy to the specified location

sudo cp ./docker-compose-linux-x86_64  /usr/local/lib/docker/cli-plugins/docker-compose

# Grant execution permissions

sudo chmod +x /usr/local/lib/docker/cli-plugins/docker-compose

Check if the installation is complete

docker compose version

Normal output of the version number is sufficient.

Deploy Core#

cd

mkdir -p mx-space/server

cd mx-space/server

wget https://fastly.jsdelivr.net/gh/mx-space/core@master/docker-compose.yml

wget https://fastly.jsdelivr.net/gh/mx-space/core@master/.env.example -O .env

Use Baota or vim to edit this .env file, an example of the file is as follows

# THIS ENV FILE EXAMPLE ONLY FOR DOCKER COMPOSE
# SEE https://docs.docker.com/compose/environment-variables/#the-env-file
JWT_SECRET=7294c34e0b28ad282333333          # Fill in a string with a length of no less than 16 characters and no more than 32 characters here, for example: the md5 value of hash
ALLOWED_ORIGINS=miaoer.xyz,www.miaoer.xyz,v6.www.miaoer.xyz  # Fill in the allowed domain names here, usually the domain name of kami; if multiple domain names are allowed to access, separate them with commas

Vim save: Ecs to exit editing, Shift + :(colon) input wq
Thus :wq

Pull the image#

# Pull the latest image

sudo docker compose pull

# Start the container

sudo docker compose up -d

Reverse Proxy#

Enter the Baota panel—Website, set the back-end website address here using api.miaoer.xyz.

Fill in whatever hostname you like, remember to resolve it.

Create a new site and go to Settings - Reverse Proxy - Add Reverse Proxy.

Set the proxy name here for easy management as Back-end.

Target URL: http://127.0.0.1:2333 Send domain: $host

After saving, click Configuration File and copy the configuration file text below into it, remember to select all and delete the previous configuration.

#PROXY-START/
location /socket.io {
    proxy_http_version 1.1;
    proxy_buffering off;
    proxy_set_header Upgrade $http_upgrade;
    proxy_set_header Connection "Upgrade";
    proxy_pass http://127.0.0.1:2333/socket.io;
}


location /
{
    proxy_pass http://127.0.0.1:2333/;
    proxy_set_header Host $host;
    proxy_set_header X-Real-IP $remote_addr;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    proxy_set_header REMOTE-HOST $remote_addr;

    add_header X-Cache $upstream_cache_status;

    #Set Nginx Cache


    set $static_fileJsNv8TWb 0;
    if ( $uri ~* "\.(gif|png|jpg|css|js|woff|woff2)$" )
    {
    	set $static_fileJsNv8TWb 1;
    	expires 12h;
        }
    if ( $static_fileJsNv8TWb = 0 )
    {
    add_header Cache-Control no-cache;
    }
}

#PROXY-END/

Configure SSL Certificate#

Here we use the free SSL certificate provided by Tencent Cloud, select Nginx when downloading the SSL certificate, open the compressed package and copy the text of the .key and .pem key and certificate files to

Site Settings - SSL - Other Certificates, the video has been blurred for privacy reasons.

Remember to delete the empty line at the end of the .pem file.

After saving, you can choose to enable forced HTTPS, it is recommended to enable it.

Initialization#

Access the back-end address https://server.test.cn/proxy/qaqdmin for initialization.

Not demonstrated in the video; after the new version of mx is updated, you need to fill in the API address and Gateway address.

For demonstration, I will fill in here;

API Address: https://api.miaoer.xyz/api/v2

Gateway Address: https://api.miaoer.xyz

Enable persistence.

Site Settings set the site title and site description.

Keywords are optional.

The front-end address needs to be manually changed to the address you want, I set it to https://www.miaoer.xyz.

The API address is correct by default, e.g., https://api.miaoer.xyz/api/v2.

The back-end address is also correct, it is not recommended to change it here.

The gateway is also correct by default.

When it comes to Owner Information, it is recommended to fill everything out.

Please note that the email refers to the address for receiving friend link and comment notifications, which should be set in the back-end panel later.

The password here is the password for the back-end panel, confirm the password.

Set your personal homepage to your front-end address, I set it to https://www.miaoer.xyz.

Set your avatar address here; you can upload your avatar through the back-end later. It is recommended to build your own CDN image bed, or use an existing one; I chose to build my own.

Fill in your personal introduction according to your preference.

Deploy Front-end#

cd
cd mx-space

git clone https://github.com/mx-space/kami.git --depth=1

# In case of poor network, please use the command below.

git clone https://hub.fastgit.xyz/mx-space/kami.git --depth=1

Switch branches to the stable version.

cd kami && git fetch --tags && git checkout $(git rev-list --tags --max-count=1)

Modify env

Use Baota or vim to edit this .env file, an example of the file is as follows

# API Address
NEXT_PUBLIC_API_URL=https://api.miaoer.xyz/api/v2
# GATEWAY Address
NEXT_PUBLIC_GATEWAY_URL=https://api.miaoer.xyz
# Configuration item name used by the front-end
NEXT_PUBLIC_SNIPPET_NAME=kami
# If using CDN, modify the product prefix
ASSETPREFIX=

Vim save: Ecs to exit editing, Shift + :(colon) input wq
Thus :wq

Install dependencies

pnpm i

Build

pnpm build

Start the front-end

pm2 start

Add site

Enter the Baota panel—Website, set the front-end website address here using www.miaoer.xyz.

Fill in whatever hostname you like, remember to resolve it.

Create a new site and go to Settings - Reverse Proxy - Add Reverse Proxy.

Set the proxy name here for easy management as Front-end.

Target URL: http://127.0.0.1:2323 Send domain: $host

After saving, click Configuration File and copy the configuration file text below into it, remember to select all and delete the previous configuration.

In Kami v3.15.1 and above, the configuration is different from the previous video, please use the reverse proxy configuration below.

#PROXY-START/

location ~* \/(feed|sitemap|atom.xml)
{
    proxy_pass http://127.0.0.1:2333/$1;
    proxy_set_header Host $host;
    proxy_set_header X-Real-IP $remote_addr;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    proxy_set_header REMOTE-HOST $remote_addr;
    
    add_header X-Cache $upstream_cache_status;
     
    add_header Cache-Control max-age=60;
} 

location /
{
    proxy_pass http://127.0.0.1:2323;
    proxy_set_header Host $host;
    proxy_set_header X-Real-IP $remote_addr;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    proxy_set_header REMOTE-HOST $remote_addr;

    add_header X-Cache $upstream_cache_status;

    #Set Nginx Cache


    set $static_fileSw1Jy3nG 0;
    if ( $uri ~* "\.(gif|png|jpg|css|js|woff|woff2)$" )
    {
    	set $static_fileSw1Jy3nG 1;
    	expires 12h;
    }
    if ( $static_fileSw1Jy3nG = 0 )
    {
    add_header Cache-Control no-cache;
    }
}
#PROXY-END/

Configure SSL certificate

Very similar to the front and back ends, I hope you can think critically.

Cloud Functions and Testing#

The meaning of this segment of the video is that deployment stops here, and the rest can be completed according to the documentation for Mix-space!

So this is just a partial reference demonstration; for specifics, see Getting Started Instructions | Mix Space

Enter the back-end, move to Other · Configuration and Cloud Functions.

Create a new item:

Name: kami
Reference: theme
Data Type: YAML / JSON
Public: Yes

Refer to the following content, copy it into the box on the right, and modify it according to your situation. Below is an example in YAML format, which can be modified according to the example.

There are a lot of jsd links inside, please handle them properly.

Configuration Example#

name: kami

site:
  favicon: https://fastly.jsdelivr.net/gh/mx-space/kami@master/public/favicon.svg
  # Splash screen and logo svg tag, note XSS
  logo_svg: <svg height="200px" viewbox="0 0 200 200" version="1.1" shape-rendering="geometricPrecision"><g stroke="none" strokewidth="1" fill="none" fillrule="evenodd"><g id="forest" fill="currentColor" fillrule="nonzero"><path d="M116.799219,176.953125 C112.484375,176.953125 108.986719,180.450781 108.986719,184.765625 L108.986719,192.1875 C108.986719,196.502344 112.484375,200 116.799219,200 C121.114062,200 124.611719,196.502344 124.611719,192.1875 L124.611719,184.765625 C124.611719,180.450781 121.114063,176.953125 116.799219,176.953125 Z" id="Path"></path><path d="M121.456641,150.248047 C121.298828,150.158203 108.089453,142.472656 101.778125,128.767188 C106.058594,127.733594 109.462109,126.055078 112.442578,124.584766 C115.008203,123.319531 116.671094,120.749609 116.787109,117.891406 C116.903125,115.033203 115.441797,112.336328 112.986719,110.867578 C108.091406,107.937891 96.6117187,99.3179688 91.234375,88.9808594 C94.3324219,88.1222656 97.3414062,86.940625 100.255469,85.734375 C102.819922,84.6730469 104.628906,82.3304688 105.007422,79.5808594 C105.385938,76.83125 104.276953,74.0875 102.094531,72.3722656 C82.3632812,56.8691406 70.0417969,20.1820313 69.9210937,19.8171875 C68.8640625,16.6136719 65.8710938,14.4558594 62.5019531,14.4558594 C62.4839844,14.4558594 62.465625,14.4558594 62.4472656,14.4558594 C59.05625,14.4792969 56.0664063,16.690625 55.0484375,19.925 C54.934375,20.2878906 43.3839844,56.3890625 22.3355469,71.8246094 C20.075,73.4824219 18.8757813,76.2242188 19.1933594,79.0097656 C19.5109375,81.7949219 21.2964844,84.196875 23.8722656,85.303125 C26.1265625,86.2714844 29.5851563,87.7554688 34.3464844,89.0640625 C29.0214844,98.8472656 17.2527344,107.819922 12.2683594,110.952734 C9.7640625,112.517969 8.35625,115.360938 8.63007813,118.301563 C8.90390625,121.242188 10.8117188,123.776953 13.5617188,124.852734 C13.9058594,124.9875 14.2785156,125.1375 14.6828125,125.3 C16.8089844,126.154297 19.7445313,127.332031 23.6902344,128.501953 C17.2066406,141.350391 3.68632813,150.395703 3.53671875,150.494141 C1.09140625,152.094922 -0.25625,154.926563 0.044140625,157.833594 C0.34453125,160.740625 2.2421875,163.237109 4.96328125,164.303906 C5.76640625,164.61875 23.6132813,171.474609 55.471875,172.521875 L55.471875,192.1875 C55.471875,196.502344 58.9695313,200 63.284375,200 C67.5992187,200 71.096875,196.502344 71.096875,192.1875 L71.096875,172.544531 C103.353125,171.572656 119.956641,164.517578 120.696484,164.196094 C123.407422,163.016797 125.221094,160.408984 125.382422,157.457031 C125.542578,154.504688 124.023438,151.714844 121.456641,150.248047 Z M63.6742188,157.03125 C46.6414063,157.03125 33.3425781,155.194922 24.325,153.367578 C29.7734375,147.926953 35.75625,140.533203 39.3648438,131.730859 C44.5152344,132.389453 50.4929688,132.8125 57.4242188,132.8125 C61.7390625,132.8125 65.2367188,129.314844 65.2367188,125 C65.2367188,120.685156 61.7390625,117.1875 57.4242188,117.1875 C46.7472656,117.1875 38.8265625,116.116406 32.8878906,114.769531 C33.4640625,114.256641 34.0460937,113.726953 34.63125,113.180859 C42.2988281,106.020703 47.5574219,98.8085938 50.3394531,91.6605469 C51.3,91.7195313 52.2839844,91.7652344 53.2945313,91.7941406 C57.6179688,91.9210938 61.2035156,88.5207031 61.3269531,84.2082031 C61.45,79.8949219 58.0535156,76.2988281 53.740625,76.1757813 C49.2144531,76.0464844 45.3546875,75.5386719 42.0863281,74.8628906 C51.1160156,64.9648438 57.9273437,52.8929688 62.5585937,43.0527344 C67.1378906,52.8117188 73.746875,64.7949219 82.1886719,74.6710938 C81.9644531,74.6675781 81.74375,74.6566406 81.5277344,74.6382813 C79.1414062,74.4355469 76.7910156,75.3363281 75.1546875,77.0871094 C73.5183594,78.8375 72.7753906,81.2421875 73.1398437,83.6105469 C75.0921875,96.3007813 83.7679687,106.876563 91.5785156,114.065234 C89.2605469,114.0125 87.06875,114.98125 85.5433594,116.714844 C83.9519531,118.523438 83.2839844,120.964844 83.7328125,123.33125 C86.2589844,136.650391 93.8433594,146.823047 100.754297,153.641797 C92.2726562,155.367188 79.8890625,157.03125 63.6742188,157.03125 Z" id="Shape"></path><path d="M199.920703,162.187891 C199.623438,160.078516 198.473047,158.178125 196.74375,156.933203 C196.677734,156.885547 190.046094,152.078516 183.367188,144.459375 C178.680469,139.112891 175.16875,133.808203 172.869141,128.615234 C177.176953,127.299219 180.334766,125.896484 182.855078,124.776563 C183.779688,124.365625 184.578125,124.011328 185.239063,123.752344 C187.985938,122.677344 189.889453,120.144141 190.166016,117.207422 C190.442578,114.270703 189.037891,111.426172 186.539844,109.857031 C180.508203,106.06875 165.928516,94.9003906 160.170313,82.8882813 C165.975,81.6109375 170.135938,80.0996094 173.450781,78.6757813 C176.026953,77.5691406 177.8125,75.1675781 178.130078,72.3824219 C178.447656,69.596875 177.248438,66.8550781 174.987891,65.1972656 C150.69375,47.3816406 137.426172,5.89023438 137.296484,5.47773438 C136.282422,2.23945312 133.294141,0.02578125 129.900781,0 C129.880469,0 129.860938,0 129.840625,0 C126.471875,0 123.479297,2.1609375 122.422266,5.36484375 C122.345703,5.59726563 114.594141,28.8386719 101.137891,48.2902344 C98.6832031,51.8386719 99.5699219,56.7050781 103.118359,59.1597656 C106.666016,61.6144531 111.532813,60.7277344 113.987891,57.1796875 C120.606641,47.6113281 125.908984,37.3730469 129.771094,28.9074219 C135.158203,40.7210938 143.499219,55.9507812 154.835547,68.0292969 C148.182031,69.3046875 138.466406,70.365625 124.221094,70.365625 C119.90625,70.365625 116.408594,73.8632812 116.408594,78.178125 C116.408594,82.4929687 119.90625,85.990625 124.221094,85.990625 C131.989844,85.990625 138.586719,85.7003906 144.237891,85.2101562 C147.194141,93.6328125 153.265625,102.16875 162.363672,110.664453 C163.722266,111.933203 165.067578,113.123437 166.365234,114.225781 C160.423047,115.830469 152.078516,117.127344 139.455469,117.127344 C135.140625,117.127344 131.642969,120.625 131.642969,124.939844 C131.642969,129.254687 135.140625,132.752344 139.455469,132.752344 C146.397656,132.752344 152.275391,132.379297 157.298828,131.778516 C160.196094,139.490625 164.986719,147.194531 171.617578,154.758984 C173.749219,157.191406 175.869141,159.373437 177.836328,161.269531 C171.480469,162.880469 160.966797,164.453125 144.142969,164.453125 C139.828125,164.453125 136.330469,167.950781 136.330469,172.265625 L136.330469,192.1875 C136.330469,196.502344 139.828125,200 144.142969,200 C148.457813,200 151.955469,196.502344 151.955469,192.1875 L151.955469,179.966016 C166.112109,179.546484 177.524219,177.948828 185.952344,175.201562 C193.906641,172.608203 197.119922,169.648438 198.327734,168.114453 C199.645703,166.441016 200.217969,164.297266 199.920703,162.187891 Z" id="Path"></path></g></g></svg>
  # Random images
  figure:
    - https://fastly.jsdelivr.net/gh/Innei/fancy@master/2021/qsNmnC2zHB5FW41.jpg
    - https://fastly.jsdelivr.net/gh/Innei/fancy@master/2021/GwJzq4SYtClRcZh.jpg
    - https://fastly.jsdelivr.net/gh/Innei/fancy@master/2021/6nOYcygRGXvpsFd.jpg
    - https://fastly.jsdelivr.net/gh/Innei/fancy@master/2021/Qr2ykmsEFpJn4BC.jpg
    - https://fastly.jsdelivr.net/gh/Innei/fancy@master/2021/KiOuTlCzge7JHh3.jpg
    - https://fastly.jsdelivr.net/gh/Innei/fancy@master/2021/sM2XCJTW8BdUe5i.jpg
    - https://fastly.jsdelivr.net/gh/Innei/fancy@master/2021/18KQYP9fNGbrzJu.jpg
    - https://fastly.jsdelivr.net/gh/Innei/fancy@master/2021/rdjZo6Sg2JReyiA.jpg
    - https://fastly.jsdelivr.net/gh/Innei/fancy@master/2021/X2MVRDe1tyJil3O.jpg
    - https://fastly.jsdelivr.net/gh/Innei/fancy@master/2021/EDoKvz5p7BXZ46U.jpg
    - https://fastly.jsdelivr.net/gh/Innei/fancy@master/2021/EGk4qUvcXDygV2z.jpg
    - https://fastly.jsdelivr.net/gh/Innei/fancy@master/2021/5QdwFC82gT3XPSZ.jpg
    - https://fastly.jsdelivr.net/gh/Innei/fancy@master/2021/KPyTCARHBzpxJ46.jpg
    - https://fastly.jsdelivr.net/gh/Innei/fancy@master/2021/7TOEIPwGrZB1qFb.jpg
    - https://fastly.jsdelivr.net/gh/Innei/fancy@master/2021/Ihj5QAZgVMqr9fJ.jpg
    - https://fastly.jsdelivr.net/gh/Innei/fancy@master/2021/KZ6jv8C92Vpwcih.jpg
  # Background images
  background:
    src:
      # Light background
      light: https://fastly.jsdelivr.net/gh/mx-space/docs-images@master/assets/background.png
      # Dark background
      dark: https://fastly.jsdelivr.net/gh/mx-space/docs-images@master/assets/background-night.png
    position: top center fixed
  # Define the website top bar
  header:
    menu:
      - title: Source
        path: /
        type: Home
        icon: faDotCircle
        subMenu: []
      - title: Literature
        path: /posts
        type: Post
        subMenu: []
        icon: faGlasses
      - title: Notes
        type: Note
        path: /notes
        icon: faFeatherAlt
      - title: Sayings
        path: /says
        icon: faComments
      - title: Timeline
        icon: faHistory
        path: /timeline
        subMenu:
          - title: Life
            icon: faFeatherAlt
            path: /timeline?type=note
          - title: Blog
            icon: faBookOpen
            path: /timeline?type=post
          - title: Memories
            icon: faCircle
            path: /timeline?memory=1
      - title: Friends
        icon: faUserFriends
        path: /friends
      - title: Recent
        icon: faComment
        path: /recently
      - title: Favorites
        icon: faCircleNotch
        path: /favorite/music
        subMenu:
          - title: Listen to Music
            icon: faMusic
            type: Music
            path: /favorite/music
      - title: ""
        icon: faSubway
        path: "https://travellings.link"
  # Define social IDs under the avatar
  social:
    - url: "https://github.com/Innei"
      title: GitHub
      icon: faGithub
      color: var(--black)
    - url: "https://jq.qq.com/?_wv=1027&k=5t9N0mw"
      title: QQ
      icon: faQq
      color: "#12b7f5"
    - url: "https://twitter.com/__oQuery"
      title: Twitter
      icon: faTwitter
      color: "#02A4ED"
  # Define the website footer
  footer:
    background:
      src:
        dark: |-
        light: https://fastly.jsdelivr.net/gh/mx-space/docs-images@master/assets/footer.png
      position: top/cover
    # Default return address
    home_page: https://innei.ren
    # Footer motto
    motto:
      content: Stay hungry. Stay foolish.
      author: Steve Jobs
    # ICP record
    icp:
      enable: false
      label: "浙ICP备 20028356 号"
      link: http://beian.miit.gov.cn/
    # Custom footer text and links
    navigation:
      - name: About
        path: "/about"
      - name: Messages
        path: "/message"
      - name: Friend Links
        path: "/friends"
      - name: RSS Subscription
        path: "/feed"
        newtab: true
      - name: Sitemap
        path: "/sitemap"
        newtab: true
      - name: Travel
        path: https://travellings.link/
        newtab: true
  # Custom scripts, styles, and JS (supports external link introduction, no need for script tags)
  custom:
    # Custom scripts
    script: |-
      console.log('Hello')
    # Custom styles
    style: |-
      .foo {
        color: red
      }
    # Introduce external JS, no need for script tags
    js:
      - https://fastly.jsdelivr.net/gh/stevenjoezhang/live2d-widget@latest/autoload.js
    # Introduce external CSS 
    css:
      - https://fastly.jsdelivr.net/npm/font-awesome/css/font-awesome.min.css
# Define functions, such as playlists, tracking
function:
  player:
    # Default playlist
    # Only supports NetEase Cloud
    id:
      - 563534789
      - 1447327083
      - 1450252250
  # Analysis, Google OR Baidu OR umami
  analyze:
    enable: false
    ga: ""
    baidu: ""
    umami: ""
  # Donations
  donate:
    enable: false
    link: https://afdian.net/@Innei
  # Whether to disable debugging tools (visitors)
  ban_devtool:
    enable: false

Test Front-end#

After configuring the front-end cloud function configuration, you can now access it by entering https://www.miaoer.xyz.

I have rolled back to the normal back-end, so I have articles here; by default, there are no articles. If there are no issues, you can try writing and publishing an article in the back-end for testing.

Settings#

In the back-end panel under Settings - System, there are:

Website Settings
SEO Optimization
Additional Back-end Settings
Text Settings
Email Notification Settings
Comment Settings
Bark Notification Settings
Friend Link Settings
Backup
Baidu Push Settings
Algolia Search
Terminal Settings

I won't explain each one here.

Please refer to the content in the documentation of Getting Started Instructions | Mix Space.

Also, regarding configuration and cloud functions, due to space constraints, I will not explain it here; you can check the documentation for this part Cloud Functions.

Upgrade and Backup#

1. Custom Upgrade - Front-end#

Rename the mx-space/kami folder to any name, here changed to kami.d.

Then pull the kami front-end repository, updating to the stable version.

cd
cd mx-space

git clone https://github.com/mx-space/kami.git --depth=1

cd kami && git fetch --tags && git checkout $(git rev-list --tags --max-count=1)

Then copy the files that were modified during the previous configuration, such as .env and the public folder from mx-space/kami.d to mx-space/kami.

Assuming that the friend link page source code has been updated, replace it accordingly.

If the friend link page source code has updates, replacing it with the files from before the update may lead to build errors.

After replacement; install dependencies, build, and start the front-end.

pnpm i

pnpm build

pm2 start

# For safety: pnpm i && pnpm build && pm2 start

2. Force Sync - Front-end#

Directly execute git pull origin master in the mx-space/kami folder.

Install dependencies, build, and start the front-end.

pnpm i

pnpm build

pm2 start

# For experienced users: pnpm i && pnpm build && pm2 start

This method is suitable for lazy users who have not made changes to the Kami source code.

Back-end Upgrade#

Since the Mix-space back-end uses Docker-compose, upgrading is very convenient.

cd
cd mx-space/server

Enter the server folder and execute

docker compose pull && docker compose up -d

Backup and Rollback#

Backup#

In the back-end, under Other - Backup, click Immediate Backup, which backs up to the absolute directory:

/root/mx-space/server/data/mx-space/backup/20xx-xx-xx_xx:xx:xx/backup-20xx-xx-xx_xx:xx:xx.zip

If you haven't modified anything, see the back-end panel under Settings - System - Backup for details.

Rollback#

In the back-end, under Other - Backup, click Immediate Backup, upload the backup.zip from your computer to the recently generated backup directory for renaming and replacement.

tip
For example, if the recently generated backup is backup-2022-09-01_23:33:33.zip, rename the backup package you want to roll back, backup-2022-01-14_05:14:19.zip, to the same name as the recently generated backup.
mv /root/mx-space/server/data/mx-space/backup/2022-01-14_05:14:19/backup-2022-01-14_05:14:19.zip backup-2022-09-01_23:33:33.zip

⚠️ This operation involves modifying the database, please back up several working days of backups, data is invaluable, please operate with caution!

Generally, rollback will only cause the analyze data page to lose IP & PV data.

After replacement, it will prompt that the database has changed, and the page will reload in x seconds.

Reload to check if articles and comments are missing.

Here, in order to synchronize with the video version, the blog can only be updated to this point. For more details, check Docs.

Feel free to leave comments, donate with one click for the video; be sure to comment and like, this blog is still being updated!

This article is synchronized and updated to xLog by Mix Space. The original link is https://www.miaoer.net/posts/blog/mx-install