全系统部署指南

服务器拓扑 · 环境要求 · 各系统部署路径 · 运维要点

一、服务器拓扑

系统	域名	端口	技术栈	部署路径
统一认证 SSO	auth.guobiao.xin	8700	Python/FastAPI	/opt/guobiao-auth
工作手机管理	hr.guobiao.xin	8200	Python/FastAPI + Vue	/opt/work-phone-system
智慧物业	property.guobiao.xin	8090	Java/Spring Boot	/opt/gansu-property
智能财税	etax.guobiao.xin	8500	Java/Spring Boot	/opt/etax
郭标聊天	chat.guobiao.xin	-	Node/前端	/opt/guobiao-chat
郭标表单	bd.guobiao.xin	8600	Python/FastAPI	/opt/guobiao-form
合同管理	contract.guobiao.xin	-	Python	/opt/guobiao-contract
HR 人事/财务	hr.guobiao.xin	8000	Python/FastAPI	/opt/guobiao-platform
私有邮箱	mail.guobiao.xin	25/465/587/143/993	Postfix + Dovecot + PHP	系统级
对象存储	-	9000	MinIO (Docker)	guobiao-minio 容器
缓存	-	6379	Redis (Docker)	guobiao-redis 容器

二、环境要求

操作系统: Alibaba Cloud Linux 3 (兼容 CentOS 8/RHEL 8)
硬件要求: 4核 8G 起 (当前 2核3.5G 已承载全部系统)
存储: 40G SSD 起
依赖: Nginx 1.24 + PostgreSQL + Node 24 + Python 3.11 + JDK 17 + Docker

三、各系统部署要点

1. 统一认证 SSO

路径: /opt/guobiao-auth
启动: systemctl start guobiao-auth (端口 8700)
数据库: guobiao_auth 库 (sso_users + user_realname 表)
密钥: /etc/systemd/system/guobiao-auth.service 的 GUOBIAO_SSO_SECRET
接口: POST /sso/login, POST /sso/register, GET /sso/me
外部: https://auth.guobiao.xin/sso/

2. 工作手机管理

路径: /opt/work-phone-system
后端: systemctl start work-phone (端口 8200, uvicorn)
前端: /opt/work-phone-system/frontend-src (npm run build → dist)
数据库: work_phone 库
APK: /opt/work-phone-system/android (gradle 构建) + wp_apk_publish.sh
SSO: 已接入统一认证 (login 优先走 SSO)
外部: https://hr.guobiao.xin/work-phone/

3. 智慧物业

路径: /opt/gansu-property
启动: systemctl start gansu-property (端口 8090)
数据库: H2 文件 /opt/gansu-property/data/gansu_property.mv.db
前端: /opt/gansu-property/frontend/dist
外部: https://property.guobiao.xin/

4. 私有邮箱

组件: Postfix (SMTP) + Dovecot (IMAP) + PHP Webmail
账号管理: bash /opt/scripts/mail_manage.sh {adduser|deluser|list}
Web 邮箱: https://mail.guobiao.xin/
外部发信: 163 中继 (relayhost smtp.163.com:465)
说明: 阿里云 25 端口不可解封, 收外部信受限, 发信走 465/587

四、统一运维入口

# 备份 (每天 2:30 自动)
/opt/scripts/full_backup_v2.sh

# 邮箱备份 (每天 4:00 自动)
/opt/scripts/mail_backup.sh

# 健康监控 (每 5 分钟自动)
/opt/scripts/health_monitor.sh

# 密码清单
/opt/keystores/密码管理清单.md