本文档提供了使用 Docker 部署 AriaNg 的详细说明。

1. 克隆项目并进入目录：

git clone <repository-url>
cd AriaNg-docker

2. 使用 Docker Compose 启动：

docker-compose up -d

3. 访问应用： 打开浏览器访问 http://localhost:6800

1. 构建镜像：

docker build -t ariang .

2. 运行容器：

docker run -d \
  --name ariang \
  -p 6800:80 \
  --restart unless-stopped \
  ariang

• 默认端口：6800
• 可以通过修改 docker-compose.yml 中的端口映射来更改

• TZ: 时区设置，默认为 Asia/Shanghai

• 日志文件会保存到 ./logs 目录
• 可以根据需要挂载其他目录

如果需要自定义 Nginx 配置，可以：

1. 创建 nginx.conf 文件
2. 在 docker-compose.yml 中取消注释相关行
3. 重新启动容器

默认构建标准版本，如果需要构建一体化版本，可以修改 Dockerfile 中的构建命令：

# 将这行
RUN gulp clean build
# 改为
RUN gulp clean build-bundle

docker-compose up -d

docker-compose down

docker-compose logs -f ariang

docker-compose build --no-cache
docker-compose up -d

git pull
docker-compose build --no-cache
docker-compose up -d

1. 端口被占用

   • 检查端口 6800 是否被其他服务占用
   • 修改 docker-compose.yml 中的端口映射

2. 构建失败

   • 检查 Node.js 版本要求（需要 14+）
   • 确保网络连接正常，能够下载依赖包

3. 容器无法启动

   • 查看容器日志：docker-compose logs ariang
   • 检查 Dockerfile 和配置文件

容器包含健康检查功能，可以通过以下命令查看状态：

docker ps

• 使用多阶段构建减少最终镜像大小
• 构建阶段使用 Node.js，运行阶段使用轻量级 Nginx

• 使用 .dockerignore 排除不必要的文件
• 优化 Docker 层缓存

1. 定期更新基础镜像
2. 使用非 root 用户运行（如需要）
3. 配置适当的网络安全策略
4. 定期备份重要数据

如果遇到问题，请：

1. 查看本文档的故障排除部分
2. 检查 AriaNg 官方文档
3. 提交 Issue 到项目仓库