Docker 部署

安装 Docker

不论在海外还是中国大陆境内我们都可以使用 Linuxmirrors 提供的 Docker 安装脚本来安装 Docker 和 Docker Compose，它具备可在多种系统上安装 Docker 的能力：

bash <(curl -sSL https://linuxmirrors.cn/docker.sh)

也可使用 Docker 官方提供的安装脚本（海外）：

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

对于 Docker 镜像加速，请在网络上自行搜索或自行搭建，也可使用 1Panel 安装服务器管理的同时安装 Docker 和镜像加速。

例如 1Panel 提供了 docker.1panel.top 镜像加速源，使用方法是在 Docker 全局设置或在 docker-compose.yml 的 image 前添加镜像域名，例如 docker.1panel.top/innei/mx-server:latest 如果您成功安装了 Docker 和 Docker-Compose，可以通过以下命令查看版本：

docker -v
docker-compose -v

拉取编排文件

对于旧版本升级请注意！

自 Core v5.7.5 版本开始，Docker 相关配置发生重大变化，请重新阅读本文档（尤其是填入配置文件环节，配置有所变化）

cd && mkdir -p mx-space/core && cd $_
 
# 拉取 docker-compose.yml 文件（全球）
wget https://fastly.jsdelivr.net/gh/mx-space/core@master/docker-compose.yml
# 拉取 docker-compose.yml 文件（Gh-Proxy 全球）
wget "https://gh-proxy.org/https://github.com/mx-space/core/blob/master/docker-compose.yml"

配置环境变量

我们需要正确配置环境变量，打开获取到的docker-compose.yml文件，找到 Core 的配置。

可以看到environment字段（下方示例代码高亮部分）

  app:
    container_name: mx-server
    image: innei/mx-server:latest
    environment:
      - TZ=Asia/Shanghai
      - NODE_ENV=production
      - DB_HOST=mongo
      - REDIS_HOST=redis
      - ALLOWED_ORIGINS=localhost
      - JWT_SECRET=YOUR_SUPER_SECURED_JWT_SECRET_STRING
    volumes:
      - ./data/mx-space:/root/.mx-space

配置生成

在下方的组件中填入配置，点击复制后粘贴到 docker-compose.yml 的 environment 字段中，覆盖JWT_SECRET 和 ALLOWED_ORIGINS 的值，如果需要开启加密功能，请添加并将 ENCRYPT_ENABLE 的值改为 true，并填入 ENCRYPT_KEY。

[JWT 密钥] 长度 16-32 个字符

[被允许的域名] 多个域名用英文逗号分隔

[是否开启加密] true 或 false

[加密密钥] 开启加密时必填

变量介绍

Prop

Type

启动服务

docker compose up -d

启动后，请按以下清单确认服务正常：

docker compose ps 显示所有服务状态为 healthy
curl http://localhost:2333/api/v2/ping 返回 pong
浏览器能打开后台初始化页面 http://你的域名/proxy/qaqdmin

安装 Docker

拉取编排文件

配置环境变量

配置生成

变量介绍

启动服务

下一步

配置反向代理

前端主题部署

On this page