From ba023d248dc195c2dcc60f025596fb6147d3f3ee Mon Sep 17 00:00:00 2001 From: assast Date: Wed, 21 Jan 2026 00:04:51 +0800 Subject: [PATCH] docker --- README_DOCKER.md | 194 ++++++++++++++++++++++++++++----------------- web_outlook_app.py | 37 ++++++--- 2 files changed, 148 insertions(+), 83 deletions(-) diff --git a/README_DOCKER.md b/README_DOCKER.md index c4fe69a..5449b2f 100644 --- a/README_DOCKER.md +++ b/README_DOCKER.md @@ -2,7 +2,58 @@ ## 📦 快速开始 -### 使用 Docker Compose（推荐） +### 使用预构建镜像（推荐） + +直接使用 GitHub Actions 自动构建的镜像，无需本地构建： + +```bash +# 拉取最新镜像 +docker pull ghcr.io/assast/outlookemail:latest + +# 运行容器 +docker run -d \ + --name outlook-mail-reader \ + -p 5000:5000 \ + -v $(pwd)/data:/app/data \ + -e LOGIN_PASSWORD=admin123 \ + ghcr.io/assast/outlookemail:latest + +# 查看日志 +docker logs -f outlook-mail-reader + +# 停止容器 +docker stop outlook-mail-reader +docker rm outlook-mail-reader +``` + +**首次启动会自动：** +- 创建数据目录 +- 初始化数据库 +- 创建默认分组 +- 设置默认密码（admin123） + +### 使用 Docker Compose + +修改 `docker-compose.yml` 使用预构建镜像： + +```yaml +version: '3.8' + +services: + outlook-mail-reader: + image: ghcr.io/assast/outlookemail:latest + container_name: outlook-mail-reader + ports: + - "5000:5000" + volumes: + - ./data:/app/data + environment: + - LOGIN_PASSWORD=admin123 + - FLASK_ENV=production + restart: unless-stopped +``` + +然后启动服务： ```bash # 启动服务 @@ -15,25 +66,6 @@ docker-compose logs -f docker-compose down ``` -### 使用 Docker 命令 - -```bash -# 构建镜像 -docker build -t outlook-mail-reader . - -# 运行容器 -docker run -d \ - --name outlook-mail-reader \ - -p 5000:5000 \ - -v $(pwd)/data:/app/data \ - -e LOGIN_PASSWORD=your_password \ - outlook-mail-reader - -# 停止容器 -docker stop outlook-mail-reader -docker rm outlook-mail-reader -``` - ## 🔧 配置说明 ### 环境变量 @@ -61,44 +93,44 @@ ports: - "8080:5000" # 将容器的 5000 端口映射到主机的 8080 端口 ``` -## 🚀 GitHub Actions 自动构建 +## 🚀 镜像说明 -项目已配置 GitHub Actions，当代码推送到 `main` 或 `master` 分支时，会自动构建并推送 Docker 镜像到 `ghcr.io/assast/outlookemail:latest`。 +项目使用 GitHub Actions 自动构建并推送 Docker 镜像到 `ghcr.io/assast/outlookemail:latest`。 -### 使用预构建镜像 +### 可用镜像标签 + +- `ghcr.io/assast/outlookemail:latest` - 最新的主分支构建（推荐） +- `ghcr.io/assast/outlookemail:main` - main 分支最新版本 +- `ghcr.io/assast/outlookemail:master` - master 分支最新版本 + +### 更新镜像 ```bash -# 拉取镜像 +# 拉取最新镜像 docker pull ghcr.io/assast/outlookemail:latest -# 运行容器 +# 重启容器 +docker-compose down +docker-compose up -d +``` + +### 自己构建镜像（可选） + +如果需要修改代码或自定义构建： + +```bash +# 构建镜像 +docker build -t outlook-mail-reader . + +# 运行自己构建的镜像 docker run -d \ --name outlook-mail-reader \ -p 5000:5000 \ -v $(pwd)/data:/app/data \ - -e LOGIN_PASSWORD=your_password \ - ghcr.io/assast/outlookemail:latest + -e LOGIN_PASSWORD=admin123 \ + outlook-mail-reader ``` -### 使用生产配置 - -```bash -# 使用 docker-compose.prod.yml -docker-compose -f docker-compose.prod.yml up -d -``` - -### 触发构建 - -- 推送代码到 `main` 或 `master` 分支 -- 修改 `*.py`、`requirements.txt`、`Dockerfile`、`templates/**` 文件 -- 手动触发（在 Actions 页面点击 "Run workflow"） - -### 镜像标签 - -- `latest` - 最新的主分支构建 -- `main` 或 `master` - 分支名称 -- `main-` - 分支名+提交哈希 - ## 🌐 生产环境部署 ### 使用 Nginx + HTTPS @@ -188,21 +220,21 @@ location / { **解决方法：** ```bash -# 1. 重新构建镜像（已修复健康检查） -docker-compose down -docker-compose build -docker-compose up -d - -# 2. 查看健康检查日志 +# 1. 查看健康检查日志 docker inspect outlook-mail-reader | grep -A 10 Health -# 3. 手动测试 +# 2. 手动测试 docker exec outlook-mail-reader curl -f http://localhost:5000/login + +# 3. 使用最新镜像重启 +docker pull ghcr.io/assast/outlookemail:latest +docker-compose down +docker-compose up -d ``` ### 502 错误（Nginx） -**原因：** 应用未正常启动或使用了 Flask 开发服务器 +**原因：** 应用未正常启动 **解决方法：** @@ -216,9 +248,9 @@ docker-compose logs # 3. 测试应用是否响应 curl http://localhost:5000/login -# 4. 重新构建（使用 Gunicorn） +# 4. 重新拉取镜像并重启 +docker pull ghcr.io/assast/outlookemail:latest docker-compose down -docker-compose build docker-compose up -d ``` @@ -230,17 +262,28 @@ docker-compose up -d [INFO] Booting worker with pid: 7 ``` -### 容器无法启动 +### 数据库表不存在错误 + +**错误信息：** `sqlite3.OperationalError: no such table: settings` + +**原因：** 数据库未初始化 + +**解决方法：** ```bash -# 查看日志 -docker-compose logs +# 方法 1：删除旧数据库，重新初始化 +docker-compose down +rm -rf data/outlook_accounts.db +docker-compose up -d -# 检查端口占用 -lsof -i :5000 +# 方法 2：手动初始化数据库 +docker exec outlook-mail-reader python -c "from web_outlook_app import init_db; init_db()" +docker-compose restart -# 检查数据目录权限 -chmod 755 ./data +# 方法 3：使用最新镜像 +docker pull ghcr.io/assast/outlookemail:latest +docker-compose down +docker-compose up -d ``` ### 数据库问题 @@ -254,18 +297,25 @@ docker-compose up -d ## 🔄 更新应用 -### 从源码更新 - -```bash -git pull -docker-compose up -d --build -``` - -### 从镜像更新 +### 更新到最新版本 ```bash +# 拉取最新镜像 docker pull ghcr.io/assast/outlookemail:latest -docker-compose -f docker-compose.prod.yml up -d + +# 重启服务 +docker-compose down +docker-compose up -d + +# 或使用 Docker 命令 +docker stop outlook-mail-reader +docker rm outlook-mail-reader +docker run -d \ + --name outlook-mail-reader \ + -p 5000:5000 \ + -v $(pwd)/data:/app/data \ + -e LOGIN_PASSWORD=admin123 \ + ghcr.io/assast/outlookemail:latest ``` ## 📚 相关文档 diff --git a/web_outlook_app.py b/web_outlook_app.py index f7a2799..c82a6f4 100644 --- a/web_outlook_app.py +++ b/web_outlook_app.py @@ -49,6 +49,32 @@ GPTMAIL_API_KEY = os.getenv("GPTMAIL_API_KEY", "gpt-test") # 测试 API Key， TEMP_EMAIL_GROUP_ID = -1 +# ==================== 应用初始化 ==================== + +def init_app(): + """初始化应用（确保目录和数据库存在）""" + # 确保 templates 目录存在 + os.makedirs('templates', exist_ok=True) + + # 确保数据目录存在 + data_dir = os.path.dirname(DATABASE) + if data_dir: + os.makedirs(data_dir, exist_ok=True) + + # 初始化数据库 + init_db() + + print("=" * 60) + print("Outlook 邮件 Web 应用已初始化") + print(f"数据库文件: {DATABASE}") + print(f"GPTMail API: {GPTMAIL_BASE_URL}") + print("=" * 60) + + +# 在模块加载时初始化应用 +init_app() + + # ==================== 数据库操作 ==================== def get_db(): @@ -1553,15 +1579,6 @@ def api_update_settings(): # ==================== 主程序 ==================== if __name__ == '__main__': - # 确保 templates 目录存在 - os.makedirs('templates', exist_ok=True) - - # 确保数据目录存在 - os.makedirs('data', exist_ok=True) - - # 初始化数据库 - init_db() - # 从环境变量获取配置 port = int(os.getenv('PORT', 5000)) host = os.getenv('HOST', '0.0.0.0') @@ -1571,8 +1588,6 @@ if __name__ == '__main__': print("Outlook 邮件 Web 应用") print("=" * 60) print(f"访问地址: http://{host}:{port}") - print(f"数据库文件: {DATABASE}") - print(f"GPTMail API: {GPTMAIL_BASE_URL}") print(f"运行模式: {'开发' if debug else '生产'}") print("=" * 60)