CommaFeed Docker部署完全指南：从零到生产环境

CommaFeed Docker部署完全指南：从零到生产环境

【免费下载链接】commafeedGoogle Reader inspired self-hosted RSS reader.项目地址: https://gitcode.com/gh_mirrors/co/commafeed

CommaFeed是一款受Google Reader启发的自托管RSS阅读器，让你轻松管理和阅读各类资讯源。本指南将带你完成从环境准备到生产部署的全过程，即使是Docker新手也能快速上手。

📋 准备工作：部署前的必要检查

在开始部署前，请确保你的系统满足以下要求：

• Docker Engine 20.10.0+
• Docker Compose 2.0+
• 至少1GB可用内存
• 稳定的网络连接

🔄 快速开始：一键部署CommaFeed

1. 获取项目代码

git clone https://gitcode.com/gh_mirrors/co/commafeed cd commafeed

2. 构建Docker镜像

项目提供了两种Dockerfile配置，分别位于：

• commafeed-server/src/main/docker/Dockerfile.jvm：基于JVM的标准镜像
• commafeed-server/src/main/docker/Dockerfile.native：原生编译镜像（启动更快，资源占用更低）

使用以下命令构建JVM版本镜像：

docker build -f commafeed-server/src/main/docker/Dockerfile.jvm -t commafeed:latest .

3. 启动服务

创建并编辑docker-compose.yml文件：

version: '3' services: commafeed: image: commafeed:latest ports: - "8080:8080" environment: - COMMAFEED_DATABASE_URL=jdbc:h2:./data/commafeed - COMMAFEED_ADMIN_USER=admin - COMMAFEED_ADMIN_PASSWORD=changeme volumes: - ./data:/app/data restart: unless-stopped

启动服务：

docker-compose up -d

🖥️ 访问与初始配置

服务启动后，在浏览器中访问http://localhost:8080即可打开CommaFeed。系统会引导你完成初始设置，包括创建管理员账户和配置基本参数。

CommaFeed提供了简洁直观的用户界面，支持明暗两种主题：

CommaFeed深色主题界面 - 适合夜间阅读的RSS阅读器界面

CommaFeed浅色主题界面 - 清晰明亮的资讯阅读体验

⚙️ 生产环境优化配置

1. 数据库配置

对于生产环境，建议使用PostgreSQL替代默认的H2数据库：

environment: - COMMAFEED_DATABASE_URL=jdbc:postgresql://db:5432/commafeed - COMMAFEED_DATABASE_USER=commafeed - COMMAFEED_DATABASE_PASSWORD=securepassword services: db: image: postgres:14 environment: - POSTGRES_DB=commafeed - POSTGRES_USER=commafeed - POSTGRES_PASSWORD=securepassword volumes: - postgres_data:/var/lib/postgresql/data

2. 安全设置

• 更改默认管理员密码：登录后通过 pages/settings/ProfileSettings.tsx 页面修改
• 启用HTTPS：配合Nginx或Traefik等反向代理
• 设置适当的防火墙规则，只开放必要端口

3. 数据备份

定期备份数据卷：

docker run --rm -v $(pwd)/data:/source -v $(pwd)/backups:/backup alpine tar -czf /backup/commafeed-$(date +%Y%m%d).tar.gz -C /source .

📌 常见问题解决

服务无法启动？

检查日志获取详细信息：

docker-compose logs -f commafeed

如何更新CommaFeed？

git pull docker build -f commafeed-server/src/main/docker/Dockerfile.jvm -t commafeed:latest . docker-compose down docker-compose up -d

🎯 总结

通过本指南，你已成功部署了CommaFeed RSS阅读器。无论是个人使用还是小团队共享，CommaFeed都能满足你高效管理资讯的需求。更多高级功能和配置选项，请参考项目文档。

现在，开始享受清爽无广告的RSS阅读体验吧！

【免费下载链接】commafeedGoogle Reader inspired self-hosted RSS reader.项目地址: https://gitcode.com/gh_mirrors/co/commafeed