maizi-task 麦子战队任务进度系统(部署于 maizihehuo)

麦子团队任务/进度管理系统(FastAPI),经 kucun.bianquezhiyin.cn 的 /api 路径对外提供服务。

访问方式

• 入口:https://kucun.bianquezhiyin.cn/api/(nginx → 127.0.0.1:8770)
• 本机:curl 127.0.0.1:8770/docs(FastAPI 自带文档)
• kaku2025 有同名副本(8770,连各自 infra-mysql),双跑中

技术架构

• Python FastAPI:systemd maizi-task.service,/opt/maizi-task/.venv/bin/uvicorn app.main:app --port 8770
• 数据库:docker infra-mysql(mysql:8.0,宿主 3307)库 maizi_task(SQLAlchemy + pymysql)
• 认证:JWT(unit 文件 Environment 含 MAIZI_JWT_SECRET —— 明文存在 unit 内,位置见风险)
• 附带脚本:finish_org.py、fix_names.py、fix2/3.py、init_data.py、backup_maizi.sh

数据

• MySQL 库 maizi_task(docker 卷,数据在 /var/lib/docker 卷内)
• 备份:backup_maizi.sh + backups/ 目录;kaku2025 侧 /opt/maizi-task/backups 亦有备份

使用方法

• API 文档:/docs;前端入口在 kucun 域名下任务页
• 团队/组织数据初始化:python3 finish_org.py、init_data.py(目录内)

维护方式

• 启停:systemctl restart maizi-task
• 日志:journalctl -u maizi-task -f
• 配置:/etc/systemd/system/maizi-task.service(DB URL/JWT 均在 Environment=)
• 数据库:docker exec infra-mysql sh -c 'mysql -uroot -p"$MYSQL_ROOT_PASSWORD" maizi_task -e "show tables;"'

现状与风险

• active;两台各一套(库分叉风险:两台 infra-mysql 各有 maizi_task)
• JWT 秘钥与 DB 密码明文写在 systemd unit(位置:/etc/systemd/system/maizi-task.service 与 kaku 同款)
• infra-mysql 3307 映射 0.0.0.0

优化建议

1. 【安全】凭据改 EnvironmentFile:systemctl edit maizi-task 引入 /etc/maizi-task.env(chmod 600),unit 中删除明文行
2. 【安全】infra-mysql 改绑 127.0.0.1:3307(compose 修改)或安全组封 3307
3. 【可维护性】确定主写实例(建议 maizihehuo),停用 kaku2025 的 maizi-task,下线前 mysqldump maizi_task 做终版备份归档
4. 【备份】backup_maizi.sh 加入 cron 每日执行并落到 /opt/backups