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 登录你的服务器,执行:
按照命令行提示操作,耐心等待安装完成。成功后,控制台会打印出类似这样的访问信息:
忘记安全入口了?SSH 回到服务器,执行以下命令,entrance 字段的值就是入口路径:
如果 Docker 安装失败,先单独运行这条命令修复:
第二步 · 通过 1Panel 安装 Mix Space
2.1 下载应用包
在下面的仓库下载 mxspace.zip 文件备用:
2.2 上传应用包
登入 1Panel 面板,在左侧菜单进入 主机 → 文件,导航到路径:
点击上传,选择刚刚下载好的 mxspace.zip 文件。
2.3 解压,注意路径!
上传完成后,点击 mxspace.zip,选择解压。
这一步请务必注意!
解压时需要手动将目标路径补全为:
路径填错会导致文件散落在错误的目录里,应用商店将无法识别此本地应用。
2.4 同步本地应用
前往 1Panel 应用商店,点击右上角的同步本地应用按钮,稍等片刻后在搜索框输入 mxspace,便能看到刚刚添加的应用了。
点击安装,进入配置页面。
2.5 填写安装配置项
安装页面有三条只读说明和五个配置项,从上到下依次填写:
Note页面顶部有三条灰色的「📌」提示文字,分别说明 JWT 密钥要求、域名格式和加密功能注意事项,仅供参考,不需要修改,跳过即可。
🔑 JWT 密钥(JWT Secret)
这是后端服务的核心安全凭证,长度要求不少于 16 个字符、不超过 32 个字符。建议使用随机生成的强密码,可以在终端执行:
将生成的结果填入此处,并妥善保存——它就像这个博客系统的钥匙,丢失后需要重置,会带来一些麻烦。
🌐 被允许的域名(Allowed Origins)
填写允许访问后端 API 的前端域名,多个域名用英文逗号分隔。格式示例:
部署 Yohaku 前端时,这里填入的就是 Yohaku 所在的域名。如果暂时还不确定,可以先填 localhost:*,后续在已安装应用的配置页修改即可。
🔒 是否开启加密(Enable Encryption)
下拉选择,默认为关闭(推荐)。
🗝️ 加密密钥(Encryption Key)
仅在上一项选择「开启」时才需填写。密钥必须为 64 位小写字母和数字,可通过以下命令生成:
如选择关闭加密,此项留空即可。
🔢 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 配置,填入以下内容:
配置保存后,执行 nginx -t 检验语法,再 nginx -s reload 重载即可生效。
配置完成后,你的后端相关地址如下(后续部署 Yohaku 时会用到):
请记下这几个地址。
第四步 · 初始化后台管理
反向代理配置完成后,在浏览器访问管理后台:
首次访问会引导你完成初始化,包括创建管理员账号、填写站点基本信息等,按提示操作即可。
常见问题
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 这件漂亮的外衣吧。