sroxck

sroxck

主页归档

记录一下从零搭建并部署Mx-space + shiro的过程

212
AI 生成的摘要
mx space 是一个现代化的个人博客系统，基于 nestjs 构建，支持 mongoDB 和 Redis。shiro 是基于 mx space 的主题系统，使用 react 开发。两者在 GitHub 上均有数千个 star，功能成熟且丰富。 准备工作包括购买一台非 Windows 服务器和一个支持 HTTPS 的域名。可以选择腾讯云等服务，配置完成后需安装 Docker。接着，拉取并配置 mx space 的 docker-compose.yml 文件，设置 JWT 密钥和允许的域名。 启动 Core 后，安装 Nginx 并进行反向代理配置，确保域名和 HTTPS 证书正确设置。最后，登录后台进行初始化，并在云函数中配置前端 shiro 的相关设置。

mx space
是一个一款简洁而不简单的个人博客系统，它够快，够现代。你可以利用它构建一个属于自己的个人空间，记录生活，分享知识。mx Space 核心服务；基于 nestjs (nodejs)，需安装 mongoDB 和 Redis 方可完整运行

shiro
是基于 mx space 使用 react 开发的主题系统

以上系统在 github 均有数千 star, 比较成熟的同时有很多有趣的功能，所以本次博客重建直接使用这一套系统

准备工作#

  1. 服务器一台，非 windows 即可
  2. 域名一个，需 HTTPS

首先我们去购买一台服务器，任意配置即可，可以去找一些新客优惠，几十块钱一年的那种就可以了，这里我选择购买了腾讯云服务器，新客 79 一年 配置是 2h2g 宝塔 linux 面板

服务器购买完成后，我们在宝塔 linux 面板中重装系统，服务器默认系统为腾讯云 os, 这里从面板安装 dockerCE, 会自动配置好腾讯云镜像

也可以手动安装 docker 并设置镜像为阿里云

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

执行后查看是否成功

docker -v
 
docker compose version

至此，服务器准备工作完成

后端 mx space 部署#

配置文件拉取#

在服务器根目录进行配置文件拉取

cd && mkdir -p mx-space/core && cd $_
 
# 拉取 docker-compose.yml 文件
wget https://fastly.jsdelivr.net/gh/mx-space/core@master/docker-compose.yml

配置 Core 启动配置文件#

将下面配置文件中的值修改为你自己定义的值

- JWT_SECRET = your jwt
- ALLOWED_ORIGINS = your domain
- ENCRYPT_ENABLE = false
  • JWT 密钥：需要填写长度不小于 16 个字符，不大于 32 个字符的字符串，用于加密用户的 JWT，务必保存好自己的密钥，不要泄露给他人。
  • 被允许的域名：需要填写被允许的域名，通常是前端的域名，如果允许多个域名访问，用英文逗号，分隔。
  • 是否开启加密：如果你确定要开启加密，将 false 改为 true

启动 Core#

如果你的服务器在国内，无法拉取镜像或拉取速度过慢可自行使用代理或在 docker-compose.yml 里的 image 前添加镜像域名，比如 docker.1panel.top/innei/mx-server

docker compose up -d

Nginx 反向代理配置#

安装 Nginx#

可以使用 docker 安装，我这里使用系统安装

sudo yum install nginx
# 检查状态
sudo systemctl status nginx
# 启动服务
sudo systemctl start nginx

默认使用单域名，即后台管理系统与博客展示系统使用同一域名

另外，不管是前端还是后端的域名，都需要配置好 HTTPS 证书以保证网站能正常访问

将下面 ssl 证书替换成你自己的

server {
    listen 80;
    listen 443 ssl http2 ; 
    ## 绑定域名 
    server_name www.example.com; 
    index index.html; 
    proxy_set_header Host $host; 
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; 
    proxy_set_header X-Forwarded-Host $server_name; 
    proxy_set_header Upgrade $http_upgrade; 
    proxy_set_header Connection "upgrade"; 
    error_log /www/sites/www.example.com/log/error.log;
    access_log /www/sites/www.example.com/log/access.log; 
    location /socket.io {
        proxy_set_header Upgrade $http_upgrade; 
        proxy_set_header Connection "Upgrade"; 
        proxy_set_header Host $host; 
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; 
        proxy_set_header X-Forwarded-Proto $scheme; 
        proxy_pass http://127.0.0.1:2333/socket.io; 
    }
    location /api/v2 {
        proxy_pass http://127.0.0.1:2333/api/v2; 
    }
    location /render {
        proxy_pass http://127.0.0.1:2333/render; 
    }
    location / {
        proxy_pass http://127.0.0.1:2323; 
    }
    location /qaqdmin {
        proxy_pass http://127.0.0.1:2333/proxy/qaqdmin;
    }
    location /proxy {
        proxy_pass http://127.0.0.1:2333/proxy;
    }
 
    location ~* \/(feed|sitemap|atom.xml) {
        proxy_pass http://127.0.0.1:2333/$1; 
    }
    ssl_certificate /www/sites/www.example.com/ssl/fullchain.pem; 
    ssl_certificate_key /www/sites/www.example.com/ssl/privkey.pem; 
    ssl_protocols TLSv1.3 TLSv1.2 TLSv1.1 TLSv1; 
    ssl_ciphers 'your code'; 
    ssl_prefer_server_ciphers on; 
    ssl_session_cache shared:SSL:10m; 
    ssl_session_timeout 10m; 
    error_page 497 https://$host$request_uri; 
    limit_conn perserver 300; 
    limit_conn perip 25; 
    limit_rate 512k; 
}

反向代理成功后通过绑定域名登录后台进行初始化

前端 shiro 部署#

确保已安装 mx Space 后端并且已启动

配置云函数#

进入 mx Space 后台，进入「配置与云函数」页面，点击右上角的新增按钮，在编辑页面中，填入以下设置：

  • 名称：shiro
  • 引用：theme
  • 数据类型：JSON

按需修改为你的配置

{
  "footer": {
    "otherInfo": {
      "date": "2020-{{now}}",
      "icp": {
        "text": "萌 ICP 备 20236136 号",
        "link": "https://icp.gov.moe/?keyword=20236136"
      }
    },
    "linkSections": [
      {
        "name": "关于",
        "links": [
          {
            "name": "关于本站",
            "href": "/about-site"
          },
          {
            "name": "关于我",
            "href": "/about"
          },
          {
            "name": "关于此项目",
            "href": "https://github.com/innei/Shiro",
            "external": true
          }
        ]
      },
      {
        "name": "更多",
        "links": [
          {
            "name": "时间线",
            "href": "/timeline"
          },
          {
            "name": "友链",
            "href": "/friends"
          },
          {
            "name": "监控",
            "href": "https://status.innei.in/status/main",
            "external": true
          }
        ]
      },
      {
        "name": "联系",
        "links": [
          {
            "name": "写留言",
            "href": "/message"
          },
          {
            "name": "发邮件",
            "href": "mailto:[email protected]",
            "external": true
          },
          {
            "name": "GitHub",
            "href": "https://github.com/innei",
            "external": true
          }
        ]
      }
    ]
  },
  "config": {
    "color": {
      "light": [
        "#33A6B8",
        "#FF6666",
        "#26A69A",
        "#fb7287",
        "#69a6cc",
        "#F11A7B",
        "#78C1F3",
        "#FF6666",
        "#7ACDF6"
      ],
      "dark": [
        "#F596AA",
        "#A0A7D4",
        "#ff7b7b",
        "#99D8CF",
        "#838BC6",
        "#FFE5AD",
        "#9BE8D8",
        "#A1CCD1",
        "#EAAEBA"
      ]
    },
 
    "bg": [
      "https://github.com/Innei/static/blob/master/images/F0q8mwwaIAEtird.jpeg?raw=true",
      "https://github.com/Innei/static/blob/master/images/IMG_2111.jpeg.webp.jpg?raw=true"
    ],
    "custom": {
      "css": [],
      "styles": [],
      "js": [],
      "scripts": []
    },
    "site": {
      "favicon": "/innei.svg",
      "faviconDark": "/innei-dark.svg"
    },
    "hero": {
      "title": {
        "template": [
          {
            "type": "h1",
            "text": "Hi, I'm ",
            "class": "font-light text-4xl"
          },
          {
            "type": "h1",
            "text": "Innei",
            "class": "font-medium mx-2 text-4xl"
          },
          {
            "type": "h1",
            "text": "👋。",
            "class": "font-light text-4xl"
          },
          {
            "type": "br"
          },
          {
            "type": "h1",
            "text": "A NodeJS Full Stack ",
            "class": "font-light text-4xl"
          },
          {
            "type": "code",
            "text": "<Developer />",
            "class": "font-medium mx-2 text-3xl rounded p-1 bg-gray-200 dark:bg-gray-800/0 hover:dark:bg-gray-800/100 bg-opacity-0 hover:bg-opacity-100 transition-background duration-200"
          },
          {
            "type": "span",
            "class": "inline-block w-[1px] h-8 -bottom-2 relative bg-gray-800/80 dark:bg-gray-200/80 opacity-0 group-hover:opacity-100 transition-opacity duration-200 group-hover:animation-blink"
          }
        ]
      },
      "description": "An independent developer coding with love."
    },
    "module": {
      "activity": {
        "enable": true,
        "endpoint": "/fn/ps/update"
      },
      "donate": {
        "enable": true,
        "link": "https://afdian.net/@Innei",
        "qrcode": [
          "https://cdn.jsdelivr.net/gh/Innei/img-bed@master/20191211132347.png",
          "https://cdn.innei.ren/bed/2023/0424213144.png"
        ]
      },
      "bilibili": {
        "liveId": 1434499
      }
    }
  }
}

预构建运行#

在服务器中使用 docker 部署

mkdir shiro
cd shiro
wget https://raw.githubusercontent.com/Innei/Shiro/main/docker-compose.yml
wget https://raw.githubusercontent.com/Innei/Shiro/main/.env.template .env

vim .env # 修改你的 ENV 变量
docker compose up -d

docker compose pull # 后续更新镜像

修改 ENV 变量

# 后端api地址
NEXT_PUBLIC_API_URL=your api
# 后端网关
NEXT_PUBLIC_GATEWAY_URL=your gateway

至此就完成了 mx space + shiro 博客站点的部署，登录你的域名进行配置之后就可开始写作啦～

此文由 Mix Space 同步更新至 xLog
原始链接为 http://www.sroxck.top/posts/note/record

加载中...
此文章数据所有权由区块链加密技术和智能合约保障仅归创作者所有。