forked from DevOps/deploy.stack
125 lines
3.6 KiB
Markdown
125 lines
3.6 KiB
Markdown
# anqicms 部署栈
|
||
|
||
[anqicms](https://github.com/anqicms/anqicms) 是一个轻量、SEO 友好的中文内容管理系统，面向博客、自媒体和中小型企业建站场景，基于 Go 开发，开箱即用。
|
||
|
||
## 目录结构
|
||
|
||
| 文件 | 说明 |
|
||
|------|------|
|
||
| `stack.yml` | Docker Compose 编排文件 |
|
||
| `env.cfg.example` | 环境变量模板（不含敏感信息，可提交） |
|
||
| `env.cfg` | **实际环境变量（gitignore，不提交）** — 部署时从 example 复制 |
|
||
| `readme.md` | 本文档 |
|
||
|
||
## 服务端口
|
||
|
||
| 宿主机 | 容器 | 说明 |
|
||
|--------|------|------|
|
||
| `${ANQICMS_PORT}`（默认 `8001`） | `8001` | Web 服务（含前台 + 后台） |
|
||
|
||
宿主机端口可通过 `env.cfg` 中的 `ANQICMS_PORT` 自定义。
|
||
|
||
## 数据卷映射
|
||
|
||
| 容器路径 | 宿主机路径 | 说明 |
|
||
|----------|------------|------|
|
||
| `/app` | `${Volumes_Path}` | 应用数据根（配置、上传、缓存、主题、插件等） |
|
||
| `/etc/timezone` | `/etc/timezone` | 时区（只读） |
|
||
| `/etc/localtime` | `/etc/localtime` | 本地时间（只读） |
|
||
|
||
## 环境变量
|
||
|
||
### 公共变量（`env.cfg.example`）
|
||
|
||
| 变量 | 默认值 | 说明 |
|
||
|------|--------|------|
|
||
| `IMAGE_TAG_VER` | `latest` | anqicms 镜像版本号 |
|
||
| `IMAGE_TAG` | `anqicms/anqicms:${IMAGE_TAG_VER}` | 完整镜像引用 |
|
||
| `Volumes_Path` | `/data/volumes/anqicms` | 宿主机持久化目录 |
|
||
| `ANQICMS_PORT` | `8001` | 宿主机端口 |
|
||
|
||
## 部署步骤
|
||
|
||
### 首次部署
|
||
|
||
```bash
|
||
# 1. 准备数据目录
|
||
mkdir -pv /data/volumes/anqicms
|
||
|
||
# 2. 复制 env 模板并按需修改
|
||
cp env.cfg.example env.cfg
|
||
$EDITOR env.cfg
|
||
|
||
# 3. 拉取镜像
|
||
docker compose -p anqicms --env-file ./anqicms/env.cfg -f ./anqicms/stack.yml pull
|
||
|
||
# 4. 启动服务
|
||
docker compose -p anqicms --env-file ./anqicms/env.cfg -f ./anqicms/stack.yml up -d
|
||
```
|
||
|
||
### 首次访问
|
||
|
||
容器启动后，浏览器访问 `http://<host-ip>:${ANQICMS_PORT}/`，按安装向导完成：
|
||
|
||
- 设置管理员账号 / 密码
|
||
- 选择数据库（默认 SQLite，零外部依赖；如需 MySQL 在向导里填连接信息）
|
||
- 完成初始化
|
||
|
||
### 验证
|
||
|
||
```bash
|
||
# 容器状态
|
||
docker ps -f name=anqicms
|
||
|
||
# 端口监听
|
||
ss -tlnp | grep ${ANQICMS_PORT}
|
||
|
||
# 容器日志
|
||
docker logs -f anqicms
|
||
|
||
# 健康检查
|
||
curl -sI http://localhost:${ANQICMS_PORT}/
|
||
```
|
||
|
||
### 停止 / 重启
|
||
|
||
```bash
|
||
# 停止（保留数据）
|
||
docker compose -p anqicms --env-file ./anqicms/env.cfg -f ./anqicms/stack.yml stop
|
||
|
||
# 完全销毁（**数据不删**，bind 挂载保留在宿主机）
|
||
docker compose -p anqicms --env-file ./anqicms/env.cfg -f ./anqicms/stack.yml down
|
||
|
||
# 重启
|
||
docker compose -p anqicms --env-file ./anqicms/env.cfg -f ./anqicms/stack.yml restart
|
||
```
|
||
|
||
## 升级
|
||
|
||
```bash
|
||
# 1. 备份数据（先停服）
|
||
docker compose -p anqicms --env-file ./anqicms/env.cfg -f ./anqicms/stack.yml stop
|
||
sudo rsync -a /data/volumes/anqicms/ /data/backups/anqicms/$(date +%Y%m%d)/
|
||
|
||
# 2. 修改 IMAGE_TAG_VER 后拉取
|
||
$EDITOR env.cfg
|
||
docker compose -p anqicms --env-file ./anqicms/env.cfg -f ./anqicms/stack.yml pull
|
||
|
||
# 3. 重建并启动
|
||
docker compose -p anqicms --env-file ./anqicms/env.cfg -f ./anqicms/stack.yml up -d
|
||
```
|
||
|
||
## 故障排查
|
||
|
||
| 症状 | 排查命令 |
|
||
|------|----------|
|
||
| 容器起不来 | `docker logs -f anqicms` |
|
||
| 端口冲突 | `ss -tlnp \| grep ${ANQICMS_PORT}` |
|
||
| 无法访问 | 检查防火墙/安全组、`curl -sI http://localhost:${ANQICMS_PORT}/` |
|
||
| 数据丢失 | 确认 bind 挂载路径正确，不要用 anonymous volume |
|
||
|
||
## 相关链接
|
||
|
||
- GitHub: <https://github.com/anqicms/anqicms>
|
||
- Docker Hub: <https://hub.docker.com/r/anqicms/anqicms>
|
||
- 文档: <https://www.anqicms.com/docs> |