搜索文档
SSH 连接服务器
在 Mac 终端中使用 SSH 连接目标服务器,输入命令
ssh username@ip_addressusername:服务器用户名,通常是rootip_address:服务器公网 IP 地址。- 如果服务器设置了密码,输入密码即可连接。
如果服务器重装系统或重置密码,需清理旧的 SSH 记录,再使用 SSH 连接。
ssh-keygen -R ip_address配置密钥
SSH 连接服务器、拉取 Gitee 私有仓库,分别需要一对密钥。私钥留在生成它的机器上,只把 .pub 公钥分发出去。
SSH 密钥
- 生成密钥(
-f指定文件名,避免覆盖已有的id_ed25519):
ssh-keygen -t ed25519 -C "mac-to-server" -f ~/.ssh/server_ed25519一路回车即可;也可以设置密码短语,连接时需要输入。
- 把公钥复制到服务器:
ssh-copy-id -i ~/.ssh/server_ed25519.pub root@服务器IP如果服务器没有 ssh-copy-id,手动追加。先在本地 Mac 查看公钥:
cat ~/.ssh/server_ed25519.pub然后在服务器执行:
mkdir -p ~/.ssh && chmod 700 ~/.ssh
echo "公钥内容" >> ~/.ssh/authorized_keys
chmod 600 ~/.ssh/authorized_keys- 配置本地
~/.ssh/config,以后直接ssh igma-server:
Host igma-server
HostName 服务器IP
User root
IdentityFile ~/.ssh/server_ed25519
IdentitiesOnly yeschmod 600 ~/.ssh/config ~/.ssh/server_ed25519
ssh igma-serverGitee 密钥
- 在服务器上生成密钥(不要用默认文件名,避免和连接服务器的密钥混在一起):
ssh-keygen -t ed25519 -C "server-to-gitee" -f ~/.ssh/gitee_ed25519- 查看公钥并复制整行内容:
cat ~/.ssh/gitee_ed25519.pub- 把公钥添加到 Gitee:
- 部署公钥(Deploy Key):仓库页 → 管理 → 部署公钥管理 → 添加部署公钥。只对当前仓库生效;需要推送就勾选“可推送”。服务器只需要拉取代码时,这一种更合适。
- 账号 SSH 公钥:Gitee 设置 → 安全设置 → SSH 公钥。对账号下所有仓库生效。
注意:gitee_ed25519 是私钥,只留在服务器;gitee_ed25519.pub 才是要粘贴到 Gitee 的公钥。
- 配置服务器上的
~/.ssh/config:
Host gitee.com
HostName gitee.com
User git
IdentityFile ~/.ssh/gitee_ed25519
IdentitiesOnly yeschmod 600 ~/.ssh/config ~/.ssh/gitee_ed25519- 验证:
ssh -T git@gitee.com看到 Hi ... You've successfully authenticated 即可。如果显示 Hi Anonymous (DeployKey)!,说明用的是部署公钥,同样表示认证成功。
服务器中安装 Docker
此前使用 curl -fsSL https://get.docker.com | sh 安装 docker 的小伙伴可能因为网络问题无法安装成功,下面这套流程是使用淘宝镜像下载的,亲测成功。
- 清理可能残留的源配置
rm -f /etc/apt/sources.list.d/docker.list /etc/apt/sources.list.d/docker.sources- 基础依赖
apt-get update && apt-get install -y ca-certificates curl gnupg- 添加阿里云的 Docker GPG 密钥和软件源(Ubuntu 24.04 代号 noble)
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- 安装
apt-get update
apt-get install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin- 验证
docker --version
docker compose version配置镜像加速器并测试拉取
安装好 Docker 后先测试拉取,国内直连 Docker Hub 通常会卡住或超时:
docker run --rm hello-world我在这一步等了好久,最后还是报错了,原因是我没有配置镜像,报错信息:
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- 写入 Docker 镜像加速配置
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 秒就拉完了。所以建议把实测速度快的放在最前面。
- 校验 JSON 格式
python3 -m json.tool /etc/docker/daemon.jsondaemon.json 必须是合法 JSON。命令太长在终端里折行时,换行符可能被写进 JSON,导致 Docker 启动失败(Job for docker.service failed because the control process exited with error code)。写完后先用上面的命令校验。
- 重启 Docker 生效
systemctl daemon-reload
systemctl restart docker注意:重启 Docker 会中断正在进行的镜像拉取,但已下载完成的镜像层会保留。
- 确认加速器已生效
docker info | grep -A 3 "Registry Mirrors"此处输出下方结果,标识设置成功
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/- 再次测试拉取
docker run --rm hello-world看到 Hello from Docker! 这段就说明镜像拉取通道打通了。
安装 git 并拉取代码
在服务器中安装 git
apt-get update && apt-get install -y git把代码拉取到服务器(已配置 SSH 密钥时用 SSH 地址,免密):
git clone git@gitee.com:iGma_e/iGmaAdmin.git /opt/iGmaAdmin如果还没配置 SSH 密钥,也可以用 HTTPS 地址,克隆时输入 Gitee 用户名和密码(或私人令牌):
git clone https://gitee.com/iGma_e/iGmaAdmin.git /opt/iGmaAdminServer 仓库用于存放证书和部署脚本,也一并克隆:
git clone git@gitee.com:iGma_e/Server.git /opt/Server拉取完成后进入项目目录,后续操作都在这里执行:
cd /opt/iGmaAdmin配置 docker 文件
项目根目录的部署文件结构如下:
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/
└── .envdocker-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等无关文件。
前端构建时有一行关键配置:
RUN mkdir -p env && echo "VITE_FILE_URL_PREFIX=" > env/.env.productionVITE_FILE_URL_PREFIX 是构建时写入 JS 的,留空后文件地址会自动使用当前域名,不会写死成 http://127.0.0.1:8888。修改这个变量必须重新构建前端镜像。mkdir -p env 用于兜底,避免构建上下文里没有 env 目录时报 nonexistent directory。
生成密码配置文件
- 切换到项目根目录,后续操作均在此目录下执行。
- 从模板复制出真正的
.env
cp .env.example .env- 自动生成三组随机密码,替换掉模板里的
change-me
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- 创建上传目录,并交给容器内的运行用户(UID 1000)
mkdir -p data/upload
chown -R 1000:1000 data/upload- 确认模板占位符已全部替换(不显示密码本身)
grep "change-me" .env && echo "还有未替换的!" || echo "密码已全部生成"预期最后输出 密码已全部生成。
准备 HTTPS 证书(首次启动前)
HTTPS 配置在 Server 仓库的 gateway/nginx.conf,gateway 容器启动时就要加载证书。证书统一放在 Server 仓库的 ssl/ 目录,服务器路径为 /opt/Server/ssl。所以必须在第一次启动 gateway 之前准备好,否则 gateway 会因找不到证书反复重启。
- 域名 DNS 添加 A 记录,指向服务器公网 IP:
主机记录:www
记录类型:A
记录值:服务器公网 IP
主机记录:blog
记录类型:A
记录值:服务器公网 IP用 dig 确认生效,输出服务器 IP 说明已生效:
dig +short www.igma.ink A
dig +short blog.igma.ink A- 准备证书。Nginx 需要证书链文件 + 私钥,两个域名各一套,云厂商下载的 Nginx 格式通常包含:
www.igma.ink_bundle.pem 后台管理系统证书链
www.igma.ink.key 后台管理系统私钥
blog.igma.ink_bundle.pem 博客证书链
blog.igma.ink.key 博客私钥
*.csr 证书请求文件,用不上- 把证书放到 Server 仓库目录。如果证书已经提交到 Server 仓库,clone 后直接执行下面的 chmod 即可;否则用 scp 上传:
# 服务器
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。
- 重装系统或重新克隆项目时,
/opt/Server/ssl从 Server 仓库恢复(证书已提交时)或从备份还原;/opt/iGmaAdmin/data/upload仍需要单独从备份恢复。
启动网关(Server)
iGmaAdmin 和 iGmaBlog 都加入外部网络 igma_web,这个网络由 Server 的 gateway 创建,所以先启动 gateway:
cd /opt/Server/gateway
docker compose up -d
docker compose psgateway 占用宿主机 80/443,统一处理 www.igma.ink 和 blog.igma.ink 的 HTTPS,并分别转发到 igmaadmin-frontend:80 和 blog:80。
构建并启动
- 在项目根目录执行
docker compose up -d --build首次构建会拉取基础镜像、下载 Maven/npm 依赖并编译前后端,耗时几分钟到十几分钟都正常。
过程中会看到类似 [+] up 22/24 的输出,这不是 22 个容器,而是镜像拉取、构建阶段、容器创建、网络和数据卷创建等任务总数。
- 构建完成后检查容器状态
docker compose ps预期输出:
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,日志报错:
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 配置自然没有数据库地址。
排查:
docker compose logs backend --tail=120修复:
- 删除
SpringBoot/.gitignore中的src/main/resources/application-prod.yaml。 - 该文件里都是
${MYSQL_HOST}这类环境变量占位符,不含密码,可以放心提交。
git add .
git commit -m "提交生产配置"
git push- 服务器拉取并重新构建:
cd /opt/iGmaAdmin
git pull
docker compose up -d --build网关容器反复重启
现象:cd /opt/Server/gateway && docker compose ps 中 gateway 状态为 Restarting。
排查:
cd /opt/Server/gateway
docker compose logs --tail=50 gateway日志出现:
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 挂载,不需要重新构建):
cd /opt/Server/gateway && docker compose restart gateway数据库中文乱码
现象:菜单、表头、用户姓名、性别等中文全部显示成 å§“å、性别 这样的乱码,英文和数字正常,前端静态文字(如左上角标题)正常。
原因:MySQL 初始化导入 schema.sql、data.sql 时,客户端连接字符集是 latin1,UTF-8 编码的中文被当成 latin1 存入,读取时再按 UTF-8 解码就成了乱码。
确认数据库里的内容:
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,会清空数据库后重建,只能在还没有正式数据时使用):
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:
[client]
default-character-set=utf8mb4在 docker-compose.yml 的 mysql 服务中挂载:
volumes:
- mysql_data:/var/lib/mysql
- ./deploy/mysql-client.cnf:/etc/mysql/conf.d/client.cnf:ro这样下次全新初始化数据卷时就不会再乱码。
验证服务
服务器本机验证:
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 按最长前缀匹配:
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。
Server/gateway/docker-compose.yml占用宿主机 80/443 并挂载证书:
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_webServer/gateway/nginx.conf负责 HTTP 跳转 HTTPS,并按域名转发:
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 中。
- 证书续期:替换
/opt/Server/ssl/下的证书和私钥后重启 gateway 即可,不需要重新构建:
cd /opt/Server/gateway && docker compose restart gateway部署博客(iGmaBlog)
博客是纯静态站点,容器只连接 Docker 内网,由 Server 的 gateway 按 blog.igma.ink 域名反向代理。
git clone git@gitee.com:iGma_e/iGmaBlog.git /opt/iGmaBlog
cd /opt/iGmaBlog
docker compose up -d --buildiGmaBlog/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,无需重复克隆。如果还没有,执行:
git clone git@gitee.com:iGma_e/Server.git /opt/Server配置发件邮箱
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 已经在运行,这一步只是检查:
systemctl status cron --no-pager| 输出关键信息 | 处理方式 |
|---|---|
active (running) 且 enabled | 已就绪,直接进入下一步 |
inactive 或 disabled | 执行 systemctl enable --now cron |
Unit cron.service could not be found | 先 apt install cron,再执行上面的命令 |
添加定时任务
crontab -e加入一行(必须完整一行,不能断开):
*/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 确认没有加过):
(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 -验证
# 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有部署动作时查看日志:
tail -n 100 /var/log/igma-git-poll-deploy.log
tail -f /var/log/igma-git-poll-deploy.log- 没有新提交时日志不增长是正常的。判断"轮询有没有在跑"要看
journalctl。 - 部署失败后不会每两分钟重复构建,下一次有新提交才会再部署。需要立即重试当前
master:
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)。
日常维护
手动更新代码(未配置自动部署或需要立即生效时):
# 本地
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 开机自启)。 - 查看日志:
docker compose logs -f backend
docker compose logs -f frontend
cd /opt/Server/gateway && docker compose logs -f- 备份:定期导出 MySQL 并打包上传目录,例如:
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