Note这是「Mix Space + Yohaku 部署系列」的第一篇，专注于后端（Core）的安装。前端主题 Yohaku 的部署请移步第二篇。
Mix Space 是一套现代化的前后端分离个人博客系统。后端 Core 提供 RESTful API、定时任务、备份、无服务器函数等全套服务，是整个系统安静运转的心脏；前端主题则与之分离，可以自由搭配。
这篇文章会带你用 1Panel 面板，把 Mix Space 后端跑在自己的服务器上——不需要太多折腾，一步一步来就好。
第一步 · 安装 1Panel 面板
1Panel 是一款现代化的开源 Linux 服务器运维面板，界面清爽、操作直观。有了它，后续的容器管理、文件上传、反向代理，都会变得格外顺手。
安装前的小小确认
| 检查项 | 要求 |
|---|---|
| 操作系统 | 主流 Linux 发行版（Debian / Ubuntu / CentOS 等） |
| 服务器架构 | x86_64、aarch64、armv7l 等均支持 |
| 可用内存 | 建议 1 GB 以上 |
| 网络环境 | 需能正常访问互联网 |
| 浏览器 | Chrome、Firefox、Edge 等现代浏览器 |
一行命令，完成安装
SSH 登录你的服务器，执行：
CodeBlock Loading...
按照命令行提示操作，耐心等待安装完成。成功后，控制台会打印出类似这样的访问信息：
CodeBlock Loading...
云服务器用户请注意：记得在安全组中开放对应端口，否则浏览器将无法访问面板。
忘记安全入口了？SSH 回到服务器，执行以下命令，entrance 字段的值就是入口路径：
CodeBlock Loading...
如果 Docker 安装失败，先单独运行这条命令修复：
CodeBlock Loading...
第二步 · 通过 1Panel 安装 Mix Space
2.1 下载应用包
在下面的仓库下载 mxspace.zip 文件备用：
2.2 上传应用包
登入 1Panel 面板，在左侧菜单进入 主机 → 文件，导航到路径：
CodeBlock Loading...
点击上传，选择刚刚下载好的 mxspace.zip 文件。
2.3 解压，注意路径！
上传完成后，点击 mxspace.zip，选择解压。
这一步请务必注意！
解压时需要手动将目标路径补全为：
CodeBlock Loading...
路径填错会导致文件散落在错误的目录里，应用商店将无法识别此本地应用。
2.4 同步本地应用
前往 1Panel 应用商店，点击右上角的同步本地应用按钮，稍等片刻后在搜索框输入 mxspace，便能看到刚刚添加的应用了。
点击安装，进入配置页面。
2.5 填写安装配置项
安装页面有三条只读说明和五个配置项，从上到下依次填写：
Note页面顶部有三条灰色的「📌」提示文字，分别说明 JWT 密钥要求、域名格式和加密功能注意事项，仅供参考，不需要修改，跳过即可。
🔑 JWT 密钥（JWT Secret）
这是后端服务的核心安全凭证，长度要求不少于 16 个字符、不超过 32 个字符。建议使用随机生成的强密码，可以在终端执行：
CodeBlock Loading...
将生成的结果填入此处，并妥善保存——它就像这个博客系统的钥匙，丢失后需要重置，会带来一些麻烦。
🌐 被允许的域名（Allowed Origins）
填写允许访问后端 API 的前端域名，多个域名用英文逗号分隔。格式示例：
CodeBlock Loading...
部署 Yohaku 前端时，这里填入的就是 Yohaku 所在的域名。如果暂时还不确定，可以先填 localhost:*，后续在已安装应用的配置页修改即可。
🔒 是否开启加密（Enable Encryption）
下拉选择，默认为关闭（推荐）。
加密功能不可逆，开启后若不慎丢失密钥，数据将无法恢复。非有特殊需求，建议保持关闭。
🗝️ 加密密钥（Encryption Key）
仅在上一项选择「开启」时才需填写。密钥必须为 64 位小写字母和数字，可通过以下命令生成：
CodeBlock Loading...
如选择关闭加密，此项留空即可。
🔢 HTTP 端口
默认为 2333，一般无需修改。如有端口冲突，可自行更改为其他可用端口。
Note不建议直接勾选端口外部访问，而是通过下一步的反向代理来对外提供服务，这样更安全、也更规范。
2.6 开始安装 🎉
确认配置无误，点击开始安装。
1Panel 会自动拉取 innei/mx-server、mongo:7、redis:alpine 三个镜像并编排启动。首次安装需要拉取镜像，耐心等待几分钟就好。
当状态显示为运行中（Running），Mix Space 后端就悄悄跑起来了 🌿
第三步 · 配置反向代理与 HTTPS
直接暴露端口的方式既不安全，也不美观。建议通过 Nginx 反向代理将服务绑定到你的域名，再配上 HTTPS，整套才算完整。
这里提供一份完整的 Nginx 配置，它做了一件很有意思的事——将 前端（Yohaku，端口 2323） 和 后端（Mix Space Core，端口 2333） 的路由都写在同一个 server 块里，用同一个域名对外服务。访客访问你的博客，前端页面和后端 API 悄悄在幕后各司其职，对外只露出一个干净的域名。
在 1Panel 的 网站 → OpenResty → 配置文件 中，或直接编辑服务器上的 Nginx 配置，填入以下内容：
CodeBlock Loading...
配置保存后，执行 nginx -t 检验语法，再 nginx -s reload 重载即可生效。
配置完成后，你的后端相关地址如下（后续部署 Yohaku 时会用到）：
CodeBlock Loading...
请记下这几个地址。
第四步 · 初始化后台管理
反向代理配置完成后，在浏览器访问管理后台：
CodeBlock Loading...
首次访问会引导你完成初始化，包括创建管理员账号、填写站点基本信息等，按提示操作即可。
常见问题
Q：安装后容器一直在重启，无法正常启动？
大概率是 MongoDB 或 Redis 的健康检查还没通过——它们需要一点时间完全就绪，Core 容器会自动重试。等待约 1 分钟，通常就能自己恢复。如果持续异常，可以在 1Panel 的容器日志里查看具体的报错信息。
Q：JWT 密钥忘记保存了怎么办？
在 1Panel 应用商店的已安装列表中，点击 mxspace 的编辑或配置，可以查看当前的环境变量值。
Q：想修改被允许的域名，怎么操作？
在已安装应用的配置页面中修改 ALLOWED_ORIGINS 环境变量，保存后重启容器即可生效。
Q：数据存储在哪里？
所有数据持久化存储在 /opt/1panel/apps/local/mxspace/mxspace/data/ 目录下，包含 MongoDB 数据、Redis 数据和 mx-space 运行时文件。定期备份此目录即可，也可随 1Panel 快照一并备份。
参考资料
后端已经稳稳落地了 🌱
接下来，前往第二篇，为它披上 Yohaku 这件漂亮的外衣吧。