Mix-Space部署最新后端Core
Mix Space 是一个一款简洁而不简单的个人博客系统，它够快，够现代。你可以利用它构建一个属于自己的个人空间，记录生活，分享知识。
后端Core项目
系统 / 环境要求
- Linux / MacOS （推荐Debian11 / 12）教程以Debian11 / 12为例
- Linux 内核 > 4.19
- Docker，Docker-Compose
- 1Panel+OpenResty（可选）
必要的准备
- 域名：本篇所采用为双域名模式，即前端
www.vlo.cc，后端api.vlo.cc - 前后端域名所需SSL证书：需要全站HTTPS
壹·安装Docker / Docker-Compose
若服务器在国外且需要使用1Panel，可以直接运行1Panel安装脚本，一把梭安装1Panel和Docker / Docker-Compose
首先，安装一些必要的软件包：
apt update
apt upgrade -y
apt install curl vim wget gnupg dpkg apt-transport-https lsb-release ca-certificates
然后加入 Docker 的 GPG 公钥和 apt 源：
curl -sSL https://download.docker.com/linux/debian/gpg | gpg --dearmor > /usr/share/keyrings/docker-ce.gpg
echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/docker-ce.gpg] https://download.docker.com/linux/debian $(lsb_release -sc) stable" > /etc/apt/sources.list.d/docker.list
国内机器可以用清华 TUNA 的国内源：
curl -sS https://download.docker.com/linux/debian/gpg | gpg --dearmor > /usr/share/keyrings/docker-ce.gpg
echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/docker-ce.gpg] https://mirrors.tuna.tsinghua.edu.cn/docker-ce/linux/debian $(lsb_release -sc) stable" > /etc/apt/sources.list.d/docker.list
然后更新系统后即可安装 Docker CE
apt update
apt install docker-ce docker-ce-cli containerd.io
我们可以使用 Docker 官方发布的 Github 直接安装最新版本docker-compose：
curl -L https://github.com/docker/compose/releases/latest/download/docker-compose-Linux-x86_64 > /usr/local/bin/docker-compose
chmod +x /usr/local/bin/docker-compose
此时可使用 docker-compose version 命令检查是否安装成功
贰·部署Core
一 · 拉取配置文件
cd /opt && mkdir -p mx-space/core && cd $_
# 拉取 docker-compose.yml 文件
wget https://fastly.jsdelivr.net/gh/mx-space/core@master/docker-compose.yml
二 · 修改Core配置文件
cd /opt/mx-space/core
vim docker-compose.yml
修改environment 字段对应部分的内容，调整细节使其符合 yaml 语法，保存即可。
Warning默认MongoDB数据库和Redis未设置密码，若无需要请不要放行数据库端口！若需要密码/或使用远程数据库，可根据官方文档配置（
我会啦！🥰）
JWT 密钥：需要填写长度不小于 16 个字符，不大于 32 个字符的字符串，用于加密用户的 JWT，务必保存好自己的密钥，不要泄露给他人。被允许的域名：需要填写被允许的域名，通常是前端的域名，如果允许多个域名访问，用英文逗号，分隔。（可选）是否开启加密：如果你确定要开启数据库加密，将 false 改为 true，开启加密后，你需要在下方填写加密密钥。（可选）加密密钥：如果你不知道这是什么，那么不建议开启此功能，具体内容可参考 https://mx-space.js.org/usage/security.html
此密钥用来加密数据库！如果丢失，将无法使用备份恢复！一定要记录并保存！
若开启加密，则需注意密钥长度必须为 64 位且只有小写字母和数字，不然会在初始化时报错。注意这是不可逆的，务必保存自己的秘钥。所以并不是非常推荐使用，除非你真的需要加密 API Key.
密钥可以通过 openssl rand -hex 32 命令生成。请务必牢记。
配置示例
三 · Core 启动！
cd /opt/mx-space/core
docker-compose pull && docker compose up -d
叁·反代与更新
一 · 反向代理
以1Panel+OpenResty为例：
- 新建静态网站
- 配置SSL证书开启HTTPS
- 在NGINX配置文件最后一个
}的上方另起一行，粘贴如下配置，并保存
二 · Core 初始化
反向代理配置完成，访问后端 https://后端域名/proxy/qaqdmin
例： https://api.example.cc/proxy/qaqdmin
根据页面提示完成初始化，
若完成后未正确跳转后台，
再次进入 https://api.example.cc/proxy/qaqdmin 即可
三 · Core 更新
cd /opt/mx-space/core
docker-compose pull && docker compose up -d
肆·参考文章
Debian 12 / Ubuntu 24.04 安装 Docker 以及 Docker Compose 教程
官方部署文档