Skip to content

Docker

创建时间:2026年11月15日 17:52:33

SSH 连接服务器 ​

在 Mac 终端中使用 SSH 连接目标服务器,输入命令

bash
ssh username@ip_address
  • username:服务器用户名,通常是 root
  • ip_address:服务器公网 IP 地址。
  • 如果服务器设置了密码,输入密码即可连接。

如果服务器重装系统或重置密码,需清理旧的 SSH 记录,再使用 SSH 连接。

bash
ssh-keygen -R ip_address

配置密钥 ​

SSH 连接服务器、拉取 Gitee 私有仓库,分别需要一对密钥。私钥留在生成它的机器上,只把 .pub 公钥分发出去。

SSH 密钥 ​

  1. 生成密钥(-f 指定文件名,避免覆盖已有的 id_ed25519):
bash
ssh-keygen -t ed25519 -C "mac-to-server" -f ~/.ssh/server_ed25519

一路回车即可;也可以设置密码短语,连接时需要输入。

  1. 把公钥复制到服务器:
bash
ssh-copy-id -i ~/.ssh/server_ed25519.pub root@服务器IP

如果服务器没有 ssh-copy-id,手动追加。先在本地 Mac 查看公钥:

bash
cat ~/.ssh/server_ed25519.pub

然后在服务器执行:

bash
mkdir -p ~/.ssh && chmod 700 ~/.ssh
echo "公钥内容" >> ~/.ssh/authorized_keys
chmod 600 ~/.ssh/authorized_keys
  1. 配置本地 ~/.ssh/config,以后直接 ssh igma-server:
text
Host igma-server
    HostName 服务器IP
    User root
    IdentityFile ~/.ssh/server_ed25519
    IdentitiesOnly yes
bash
chmod 600 ~/.ssh/config ~/.ssh/server_ed25519
ssh igma-server

Gitee 密钥 ​

  1. 在服务器上生成密钥(不要用默认文件名,避免和连接服务器的密钥混在一起):
bash
ssh-keygen -t ed25519 -C "server-to-gitee" -f ~/.ssh/gitee_ed25519
  1. 查看公钥并复制整行内容:
bash
cat ~/.ssh/gitee_ed25519.pub
  1. 把公钥添加到 Gitee:
  • 部署公钥(Deploy Key):仓库页 → 管理 → 部署公钥管理 → 添加部署公钥。只对当前仓库生效;需要推送就勾选“可推送”。服务器只需要拉取代码时,这一种更合适。
  • 账号 SSH 公钥:Gitee 设置 → 安全设置 → SSH 公钥。对账号下所有仓库生效。

注意:gitee_ed25519 是私钥,只留在服务器;gitee_ed25519.pub 才是要粘贴到 Gitee 的公钥。

  1. 配置服务器上的 ~/.ssh/config:
text
Host gitee.com
    HostName gitee.com
    User git
    IdentityFile ~/.ssh/gitee_ed25519
    IdentitiesOnly yes
bash
chmod 600 ~/.ssh/config ~/.ssh/gitee_ed25519
  1. 验证:
bash
ssh -T git@gitee.com

看到 Hi ... You've successfully authenticated 即可。如果显示 Hi Anonymous (DeployKey)!,说明用的是部署公钥,同样表示认证成功。

服务器中安装 Docker ​

此前使用 curl -fsSL https://get.docker.com | sh 安装 docker 的小伙伴可能因为网络问题无法安装成功,下面这套流程是使用淘宝镜像下载的,亲测成功。

  1. 清理可能残留的源配置
bash
rm -f /etc/apt/sources.list.d/docker.list /etc/apt/sources.list.d/docker.sources
  1. 基础依赖
bash
apt-get update && apt-get install -y ca-certificates curl gnupg
  1. 添加阿里云的 Docker GPG 密钥和软件源(Ubuntu 24.04 代号 noble)
bash
install -m 0755 -d /etc/apt/keyrings
curl -fsSL https://mirrors.aliyun.com/docker-ce/linux/ubuntu/gpg -o /etc/apt/keyrings/docker.asc
chmod a+r /etc/apt/keyrings/docker.asc
echo "deb [arch=amd64 signed-by=/etc/apt/keyrings/docker.asc] https://mirrors.aliyun.com/docker-ce/linux/ubuntu noble stable" > /etc/apt/sources.list.d/docker.list
  1. 安装
bash
apt-get update
apt-get install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
  1. 验证
bash
docker --version
docker compose version

配置镜像加速器并测试拉取 ​

安装好 Docker 后先测试拉取,国内直连 Docker Hub 通常会卡住或超时:

bash
docker run --rm hello-world

我在这一步等了好久,最后还是报错了,原因是我没有配置镜像,报错信息:

text
docker: Error response from daemon: failed to resolve reference "docker.io/library/hello-world:latest": failed to do request: Head                                                                    
  "https://registry-1.docker.io/v2/library/hello-world/manifests/latest": dial tcp 208.43.170.231:443: i/o timeout
  1. 写入 Docker 镜像加速配置
bash
echo '{"registry-mirrors":["https://docker.m.daocloud.io","https://docker.xuanyuan.me","https://docker.1ms.run"]}' > /etc/docker/daemon.json

注意:Docker 会按顺序使用第一个可用的加速器,不会因为某个加速器慢就自动切换。我一开始把 docker.1ms.run 放在第一位,MySQL 镜像(172MB)拉了 30 多分钟,速率只有 90KB/s 左右;后来把 docker.m.daocloud.io 放到第一位,同样的镜像 53.7 秒就拉完了。所以建议把实测速度快的放在最前面。

  1. 校验 JSON 格式
bash
python3 -m json.tool /etc/docker/daemon.json

daemon.json 必须是合法 JSON。命令太长在终端里折行时,换行符可能被写进 JSON,导致 Docker 启动失败(Job for docker.service failed because the control process exited with error code)。写完后先用上面的命令校验。

  1. 重启 Docker 生效
bash
systemctl daemon-reload
systemctl restart docker

注意:重启 Docker 会中断正在进行的镜像拉取,但已下载完成的镜像层会保留。

  1. 确认加速器已生效
bash
docker info | grep -A 3 "Registry Mirrors"

此处输出下方结果,标识设置成功

text
root@lavm-ewt9svb1iy:~# docker info | grep -A 3 "Registry Mirrors"
 Registry Mirrors:
  https://docker.m.daocloud.io/
  https://docker.xuanyuan.me/
  https://docker.1ms.run/
  1. 再次测试拉取
bash
docker run --rm hello-world

看到 Hello from Docker! 这段就说明镜像拉取通道打通了。

安装 git 并拉取代码 ​

在服务器中安装 git

bash
apt-get update && apt-get install -y git

把代码拉取到服务器(已配置 SSH 密钥时用 SSH 地址,免密):

bash
git clone git@gitee.com:iGma_e/iGmaAdmin.git /opt/iGmaAdmin

如果还没配置 SSH 密钥,也可以用 HTTPS 地址,克隆时输入 Gitee 用户名和密码(或私人令牌):

bash
git clone https://gitee.com/iGma_e/iGmaAdmin.git /opt/iGmaAdmin

Server 仓库用于存放证书和部署脚本,也一并克隆:

bash
git clone git@gitee.com:iGma_e/Server.git /opt/Server

拉取完成后进入项目目录,后续操作都在这里执行:

bash
cd /opt/iGmaAdmin

配置 docker 文件 ​

项目根目录的部署文件结构如下:

text
iGmaAdmin/
├── docker-compose.yml
├── .env.example
├── .gitignore
├── deploy/
│   ├── auto-deploy.sh
│   └── mysql-client.cnf
├── SpringBoot/
│   ├── Dockerfile
│   ├── .dockerignore
│   └── .docker/maven-settings.xml
└── Vue3/
    ├── Dockerfile
    ├── .dockerignore
    ├── nginx.conf
    └── env/
        └── .env
  • docker-compose.yml:定义 mysql、redis、backend、frontend 四个服务,以及健康检查、启动顺序、数据卷和网络。
  • SpringBoot/Dockerfile:多阶段构建,第一阶段用 Maven + JDK 21 编译 jar,第二阶段只保留 JRE 21 运行 jar,镜像更小、更安全。
  • SpringBoot/.docker/maven-settings.xml:Maven 阿里云镜像,避免构建时下载依赖超时。
  • Vue3/Dockerfile:第一阶段用 Node 22 执行 npm ci 和 npm run build,第二阶段用 Nginx 托管 dist。
  • Vue3/nginx.conf:静态资源、SPA 路由兜底、/api 和 /files 反向代理;只监听内网 HTTP 80,HTTPS 由 Server 的 gateway 终止。
  • Vue3/env/.env:前端配置(应用名、副标题、搜索表单项数量、上传数量、文件地址前缀),已在根 .gitignore 中单独放行。
  • deploy/mysql-client.cnf:强制 MySQL 客户端使用 utf8mb4,避免初始化导入中文乱码。
  • deploy/auto-deploy.sh:旧版单项目轮询脚本;自动部署已统一到 Server 仓库的 scripts/git-poll-deploy/,此文件不再使用。
  • .env.example:环境变量模板,复制成 .env 后填入真实密码,.env 已被 gitignore。
  • .dockerignore:构建时排除 node_modules、target、.idea 等无关文件。

前端构建时有一行关键配置:

dockerfile
RUN mkdir -p env && echo "VITE_FILE_URL_PREFIX=" > env/.env.production

VITE_FILE_URL_PREFIX 是构建时写入 JS 的,留空后文件地址会自动使用当前域名,不会写死成 http://127.0.0.1:8888。修改这个变量必须重新构建前端镜像。mkdir -p env 用于兜底,避免构建上下文里没有 env 目录时报 nonexistent directory。

生成密码配置文件 ​

  1. 切换到项目根目录,后续操作均在此目录下执行。
  2. 从模板复制出真正的 .env
bash
cp .env.example .env
  1. 自动生成三组随机密码,替换掉模板里的 change-me
bash
sed -i "s/change-me-root/$(openssl rand -hex 16)/" .env
sed -i "s/change-me-app/$(openssl rand -hex 16)/" .env
sed -i "s/change-me-redis/$(openssl rand -hex 16)/" .env
  1. 创建上传目录,并交给容器内的运行用户(UID 1000)
bash
mkdir -p data/upload
chown -R 1000:1000 data/upload
  1. 确认模板占位符已全部替换(不显示密码本身)
bash
grep "change-me" .env && echo "还有未替换的!" || echo "密码已全部生成"

预期最后输出 密码已全部生成。

准备 HTTPS 证书(首次启动前) ​

HTTPS 配置在 Server 仓库的 gateway/nginx.conf,gateway 容器启动时就要加载证书。证书统一放在 Server 仓库的 ssl/ 目录,服务器路径为 /opt/Server/ssl。所以必须在第一次启动 gateway 之前准备好,否则 gateway 会因找不到证书反复重启。

  1. 域名 DNS 添加 A 记录,指向服务器公网 IP:
text
主机记录:www
记录类型:A
记录值:服务器公网 IP

主机记录:blog
记录类型:A
记录值:服务器公网 IP

用 dig 确认生效,输出服务器 IP 说明已生效:

bash
dig +short www.igma.ink A
dig +short blog.igma.ink A
  1. 准备证书。Nginx 需要证书链文件 + 私钥,两个域名各一套,云厂商下载的 Nginx 格式通常包含:
text
www.igma.ink_bundle.pem    后台管理系统证书链
www.igma.ink.key           后台管理系统私钥
blog.igma.ink_bundle.pem   博客证书链
blog.igma.ink.key          博客私钥
*.csr                      证书请求文件,用不上
  1. 把证书放到 Server 仓库目录。如果证书已经提交到 Server 仓库,clone 后直接执行下面的 chmod 即可;否则用 scp 上传:
bash
# 服务器
mkdir -p /opt/Server/ssl

# 本地 Mac
scp www.igma.ink_bundle.pem www.igma.ink.key blog.igma.ink_bundle.pem blog.igma.ink.key root@服务器IP:/opt/Server/ssl/

# 服务器
chmod 600 /opt/Server/ssl/*.key
chmod 644 /opt/Server/ssl/*_bundle.pem
ls -l /opt/Server/ssl/

确认文件名与 Server/gateway/nginx.conf 里的 ssl_certificate、ssl_certificate_key 完全一致。gateway 容器会把 /opt/Server/ssl 挂载到容器内 /etc/nginx/ssl。

  1. 重装系统或重新克隆项目时,/opt/Server/ssl 从 Server 仓库恢复(证书已提交时)或从备份还原;/opt/iGmaAdmin/data/upload 仍需要单独从备份恢复。

启动网关(Server) ​

iGmaAdmin 和 iGmaBlog 都加入外部网络 igma_web,这个网络由 Server 的 gateway 创建,所以先启动 gateway:

bash
cd /opt/Server/gateway
docker compose up -d
docker compose ps

gateway 占用宿主机 80/443,统一处理 www.igma.ink 和 blog.igma.ink 的 HTTPS,并分别转发到 igmaadmin-frontend:80 和 blog:80。

构建并启动 ​

  1. 在项目根目录执行
bash
docker compose up -d --build

首次构建会拉取基础镜像、下载 Maven/npm 依赖并编译前后端,耗时几分钟到十几分钟都正常。

过程中会看到类似 [+] up 22/24 的输出,这不是 22 个容器,而是镜像拉取、构建阶段、容器创建、网络和数据卷创建等任务总数。

  1. 构建完成后检查容器状态
bash
docker compose ps

预期输出:

text
NAME                   IMAGE                       SERVICE    STATUS                    PORTS
igmaadmin-backend-1    igmaadmin-backend:latest    backend    Up (healthy)              8888/tcp
igmaadmin-frontend-1   igmaadmin-frontend:latest   frontend   Up                        80/tcp
igmaadmin-mysql-1      mysql:8.0                   mysql      Up (healthy)              3306/tcp, 33060/tcp
igmaadmin-redis-1      redis:7-alpine              redis      Up (healthy)              6379/tcp

只有 Server 的 gateway 映射了宿主机的 80 和 443;frontend、MySQL、Redis 和后端都只能通过 Docker 内部网络访问。

如果 gateway 显示 Restarting,优先检查 /opt/Server/ssl/ 下的证书是否存在、文件名是否和 Server/gateway/nginx.conf 一致,见“常见问题 / 网关容器反复重启”。frontend 本身不再加载证书。

常见问题 ​

后端容器反复重启 ​

现象:docker compose ps -a 中 backend 状态为 Restarting,日志报错:

text
Failed to configure a DataSource: 'url' attribute is not specified and no embedded datasource could be configured.
Reason: Failed to determine a suitable driver class

原因:SpringBoot/.gitignore 里有一行 src/main/resources/application-prod.yaml,导致生产配置文件从未提交到 Git。服务器拉取的代码和构建出的 jar 里都没有它,prod 配置自然没有数据库地址。

排查:

bash
docker compose logs backend --tail=120

修复:

  1. 删除 SpringBoot/.gitignore 中的 src/main/resources/application-prod.yaml。
  2. 该文件里都是 ${MYSQL_HOST} 这类环境变量占位符,不含密码,可以放心提交。
bash
git add .
git commit -m "提交生产配置"
git push
  1. 服务器拉取并重新构建:
bash
cd /opt/iGmaAdmin
git pull
docker compose up -d --build

网关容器反复重启 ​

现象:cd /opt/Server/gateway && docker compose ps 中 gateway 状态为 Restarting。

排查:

bash
cd /opt/Server/gateway
docker compose logs --tail=50 gateway

日志出现:

text
nginx: [emerg] cannot load certificate "/etc/nginx/ssl/www.igma.ink_bundle.pem": BIO_new_file() failed

原因:/opt/Server/ssl/ 下缺少证书,或文件名与 Server/gateway/nginx.conf 不一致。证书由 Server 仓库统一管理,重新克隆项目或重装服务器后需要先准备好。

修复:按“准备 HTTPS 证书”一节上传证书,然后重启 gateway(证书是 volume 挂载,不需要重新构建):

bash
cd /opt/Server/gateway && docker compose restart gateway

数据库中文乱码 ​

现象:菜单、表头、用户姓名、性别等中文全部显示成 å§“å、性别 这样的乱码,英文和数字正常,前端静态文字(如左上角标题)正常。

原因:MySQL 初始化导入 schema.sql、data.sql 时,客户端连接字符集是 latin1,UTF-8 编码的中文被当成 latin1 存入,读取时再按 UTF-8 解码就成了乱码。

确认数据库里的内容:

bash
docker compose exec mysql sh -c 'mysql -uroot -p"$MYSQL_ROOT_PASSWORD" --default-character-set=utf8mb4 -e "SELECT name, gender FROM igma_admin.system_user LIMIT 3;"'

如果仍然乱码,说明错误数据已经存进库里。

修复(注意:schema.sql 第一行是 DROP DATABASE,会清空数据库后重建,只能在还没有正式数据时使用):

bash
docker compose exec -T mysql sh -c 'mysql -uroot -p"$MYSQL_ROOT_PASSWORD" --default-character-set=utf8mb4' < SpringBoot/src/main/resources/sql/schema.sql
docker compose exec -T mysql sh -c 'mysql -uroot -p"$MYSQL_ROOT_PASSWORD" --default-character-set=utf8mb4 igma_admin' < SpringBoot/src/main/resources/sql/data.sql
docker compose restart backend

之后在浏览器按 Ctrl + Shift + R 强制刷新。

持久化修复:新增 deploy/mysql-client.cnf,强制客户端使用 utf8mb4:

ini
[client]
default-character-set=utf8mb4

在 docker-compose.yml 的 mysql 服务中挂载:

yaml
volumes:
    - mysql_data:/var/lib/mysql
    - ./deploy/mysql-client.cnf:/etc/mysql/conf.d/client.cnf:ro

这样下次全新初始化数据卷时就不会再乱码。

验证服务 ​

服务器本机验证:

bash
curl -I http://127.0.0.1
curl -s -o /dev/null -w "HTTP %{http_code}\n" --resolve www.igma.ink:443:127.0.0.1 https://www.igma.ink/api/auth/captcha
curl -s -o /dev/null -w "HTTP %{http_code}\n" --resolve blog.igma.ink:443:127.0.0.1 https://blog.igma.ink
  • 第一条应返回 301,并带有 Location: https://www.igma.ink/,说明 80 端口正确跳转 HTTPS。
  • 第二条应返回 HTTP 200,说明 HTTPS、gateway、admin frontend 和后端接口全链路打通。
  • 第三条应返回 HTTP 200,说明 gateway 到博客容器的链路正常。

然后浏览器访问 https://www.igma.ink,能打开登录页、验证码正常显示、能登录即可。直接用公网 IP 访问会被 301 到域名。

Nginx 同域名路由原理 ​

域名的分发在 Server 的 gateway 完成:www.igma.ink → igmaadmin-frontend:80,blog.igma.ink → blog:80。进入 admin frontend 后,前后端使用同一个域名,靠路径前缀区分,Nginx 按最长前缀匹配:

nginx
location /api/   { proxy_pass http://backend:8888/; }
location /files/ { proxy_pass http://backend:8888; }
location /       { try_files $uri $uri/ /index.html; }
  • 访问 https://www.igma.ink/system/user:不匹配 /api/ 和 /files/,走 location /,找不到静态文件就返回 index.html,由 Vue Router 渲染页面。
  • 访问 https://www.igma.ink/api/system/user/list:匹配 /api/,转发到后端 /system/user/list。proxy_pass 末尾的 / 会去掉 /api 前缀。
  • 访问 https://www.igma.ink/files/xxx.png:匹配 /files/,转发到后端,由 Spring Boot 的静态资源处理器返回上传文件。

前提是前端路由不要以 /api 或 /files 开头。同域名的好处是天然同源,不需要配置 CORS,www.igma.ink 只需要一张证书。

HTTPS 配置说明 ​

HTTPS 入口在 Server 仓库的 gateway,iGmaAdmin 和 iGmaBlog 都只在内网提供 HTTP。

  1. Server/gateway/docker-compose.yml 占用宿主机 80/443 并挂载证书:
yaml
services:
    gateway:
        image: nginx:1.27-alpine
        ports:
            - "80:80"
            - "443:443"
        volumes:
            - ../ssl:/etc/nginx/ssl:ro
            - ./nginx.conf:/etc/nginx/conf.d/default.conf:ro
        networks:
            - web

networks:
    web:
        name: igma_web
  1. Server/gateway/nginx.conf 负责 HTTP 跳转 HTTPS,并按域名转发:
nginx
server {
    listen 443 ssl default_server;
    server_name www.igma.ink;

    ssl_certificate /etc/nginx/ssl/www.igma.ink_bundle.pem;
    ssl_certificate_key /etc/nginx/ssl/www.igma.ink.key;

    location / {
        set $admin_upstream igmaadmin-frontend:80;
        proxy_pass http://$admin_upstream;
        proxy_set_header Host $host;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
}

server {
    listen 443 ssl;
    server_name blog.igma.ink;

    ssl_certificate /etc/nginx/ssl/blog.igma.ink_bundle.pem;
    ssl_certificate_key /etc/nginx/ssl/blog.igma.ink.key;

    location / {
        set $blog_upstream blog:80;
        proxy_pass http://$blog_upstream;
        proxy_set_header Host $host;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
}

80 端口的两个 return 301 和完整代理头在 Server/gateway/nginx.conf 中。

  1. 证书续期:替换 /opt/Server/ssl/ 下的证书和私钥后重启 gateway 即可,不需要重新构建:
bash
cd /opt/Server/gateway && docker compose restart gateway

部署博客(iGmaBlog) ​

博客是纯静态站点,容器只连接 Docker 内网,由 Server 的 gateway 按 blog.igma.ink 域名反向代理。

bash
git clone git@gitee.com:iGma_e/iGmaBlog.git /opt/iGmaBlog
cd /opt/iGmaBlog
docker compose up -d --build

iGmaBlog/docker-compose.yml 使用外部网络 igma_web,这个网络由 Server 的 gateway 创建,所以 gateway 必须先启动。之后 iGmaAdmin 和 iGmaBlog 之间没有依赖,启动顺序无所谓;iGmaAdmin 的 frontend 重建也不会影响博客。

自动部署(Server 仓库统一脚本) ​

自动部署已集中到 Server 仓库,不再使用 iGmaAdmin/deploy/auto-deploy.sh。脚本每两分钟检查 iGmaAdmin 和 iGmaBlog 的 master 分支:

  • iGmaAdmin:Vue3/ 有变更只重建 frontend,SpringBoot/ 有变更只重建 backend,两边都有则一起重建;docker-compose.yml 等部署文件有变更时重建全部服务。
  • iGmaBlog:master 有任何变更都重建博客容器。
  • 部署成功或失败都会发送邮件,内容为 [项目名][前端/后端/空]服务部署[成功/失败],[失败原因/报错信息]。

完整说明见 Server 仓库 README.md。以下命令都在服务器上执行,当前用户为 root。

准备 Server 仓库 ​

Server 仓库在前面章节已经克隆到 /opt/Server,无需重复克隆。如果还没有,执行:

bash
git clone git@gitee.com:iGma_e/Server.git /opt/Server

配置发件邮箱 ​

bash
cd /opt/Server/scripts/send-mail
cp mail.conf.example mail.conf
chmod 600 mail.conf
vi mail.conf

填写 SMTP 地址、端口、加密方式、邮箱账号和授权码。mail.conf 已被 gitignore,不会进入仓库。

检查 cron 服务 ​

大多数云服务器装完系统后 cron 已经在运行,这一步只是检查:

bash
systemctl status cron --no-pager
输出关键信息处理方式
active (running) 且 enabled已就绪,直接进入下一步
inactive 或 disabled执行 systemctl enable --now cron
Unit cron.service could not be found先 apt install cron,再执行上面的命令

添加定时任务 ​

bash
crontab -e

加入一行(必须完整一行,不能断开):

cron
*/2 * * * * /bin/bash /opt/Server/scripts/git-poll-deploy/git-poll-deploy.sh >> /var/log/igma-git-poll-deploy.log 2>&1

保存退出:

  • nano:Ctrl+O → 回车确认文件名 → Ctrl+X。
  • vim:按 Esc,输入 :wq,回车。

回到命令行后用 crontab -l 确认这一行已经写入。

  • */2 * * * *:每两分钟执行一次。
  • 脚本内部自带 flock,上一轮构建还没结束时会跳过本轮,cron 里不需要再加锁。
  • >> ... 2>&1:把标准输出和错误一并追加到日志。必须重定向,否则 cron 会丢弃脚本输出。

粘贴时注意:编辑器模板自带若干 # 开头的注释行,命令必须单独占一行。如果粘贴后行尾变成 2>&1# Edit this file...(命令和注释粘在一起),这行是坏的——# 前没有空格不会被当作注释,cron 会因重定向解析错误而根本不执行脚本。

不想用编辑器,也可以直接用命令写入(执行前先 crontab -l 确认没有加过):

bash
(crontab -l 2>/dev/null; echo '*/2 * * * * /bin/bash /opt/Server/scripts/git-poll-deploy/git-poll-deploy.sh >> /var/log/igma-git-poll-deploy.log 2>&1') | crontab -

验证 ​

bash
# 1) 手动跑一次:没有新提交时应无输出,退出码为 0
bash /opt/Server/scripts/git-poll-deploy/git-poll-deploy.sh; echo "exit=$?"

# 2) 等 2 分钟后,确认 cron 已触发
journalctl -u cron --since "5 min ago" | grep git-poll-deploy

有部署动作时查看日志:

bash
tail -n 100 /var/log/igma-git-poll-deploy.log
tail -f /var/log/igma-git-poll-deploy.log
  • 没有新提交时日志不增长是正常的。判断"轮询有没有在跑"要看 journalctl。
  • 部署失败后不会每两分钟重复构建,下一次有新提交才会再部署。需要立即重试当前 master:
bash
bash /opt/Server/scripts/git-poll-deploy/git-poll-deploy.sh --force

注意事项 ​

  • 配置完成后,任何推送到 master 的提交都会在两分钟内自动部署。不想启用时执行 crontab -r 移除(会清空当前用户全部定时任务)。
  • 脚本使用 git pull --ff-only,服务器仓库应保持只读,不要直接修改服务器上的文件,否则拉取会失败。
  • Server 仓库本身不会自动更新,修改脚本后需要 cd /opt/Server && git pull。
  • gateway 不在自动部署范围内;修改 /opt/Server/gateway 下的配置后,需要手动执行 cd /opt/Server/gateway && docker compose up -d。
  • 定时任务属于 root 用户:crontab -l 和查看 /var/log/igma-git-poll-deploy.log 都要以 root 身份执行(前面登录的就是 root,则无需 sudo)。

日常维护 ​

手动更新代码(未配置自动部署或需要立即生效时):

bash
# 本地
git push

# 服务器
cd /opt/iGmaAdmin
git pull
docker compose up -d --build

配置了上面的 cron 自动部署后,服务器端只需等待轮询,无需手动执行。

注意事项:

  • 不要执行 docker compose down -v,-v 会删除 MySQL 和 Redis 的数据卷。
  • .env 保存数据库和 Redis 密码,不要删除,也不要提交到 Git。
  • 服务器重启后容器会自动恢复(restart: unless-stopped + Docker 开机自启)。
  • 查看日志:
bash
docker compose logs -f backend
docker compose logs -f frontend
cd /opt/Server/gateway && docker compose logs -f
  • 备份:定期导出 MySQL 并打包上传目录,例如:
bash
docker compose exec -T mysql sh -c 'mysqldump -uroot -p"$MYSQL_ROOT_PASSWORD" --single-transaction --default-character-set=utf8mb4 igma_admin' > backup_$(date +%F).sql
tar czf upload_$(date +%F).tar.gz data/upload

基于 MIT 许可发布