🚀 部署指南
瑞格防火玻璃项目管理平台 → 企业微信H5应用 完整部署流程
← 返回系统首页
整体流程：购买云服务器 → 上传代码 → 配置HTTPS域名 → 企业微信后台添加应用 → 员工使用
预计耗时：约2-3小时（含服务器购买和域名备案）
每月成本：约 ¥50-100（轻量云服务器）
第一步：购买云服务器
1推荐：腾讯云轻量应用服务器
| 配置 | 推荐规格 | 参考价格 |
|---|
| CPU/内存 | 2核 2GB | 约 ¥50/月 |
| 系统盘 | 50GB SSD | 包含 |
| 带宽 | 4Mbps | 包含 |
| 操作系统 | Ubuntu 22.04 LTS | 免费 |
购买地址：https://cloud.tencent.com/product/lighthouse
2购买域名（如已有可跳过）
企业微信要求H5应用必须使用已备案的域名。
- 在腾讯云/阿里云购买域名（约 ¥35-70/年）
- 完成ICP备案（约7-15个工作日）
- 备案期间可先用服务器IP地址测试
3域名解析
在域名管理后台添加A记录：
主机记录: app
记录类型: A
记录值: 你的服务器公网IP
第二步：部署代码到服务器
1安装 Node.js
SSH 登录服务器后执行：
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt-get install -y nodejs
node -v
2上传项目文件
使用 SCP 或宝塔面板上传以下文件到服务器 /opt/app/ 目录：
app.html
server.js
package.json
css/style.css
js/
scp -r ./项目文件夹/* root@服务器IP:/opt/app/
3启动服务器
cd /opt/app
node server.js
4设置开机自启（推荐）
使用 PM2 管理进程，确保服务器重启后自动运行：
sudo npm install -g pm2
cd /opt/app
pm2 start server.js --name fire-window-system
pm2 save
pm2 startup
5开放防火墙端口
在云服务器控制台的安全组中，放行以下端口：
| 端口 | 用途 | 协议 |
|---|
| 80 | HTTP（Nginx反代） | TCP |
| 443 | HTTPS（SSL证书） | TCP |
| 3000 | Node.js后端（内部） | 不需要对外开放 |
第三步：配置HTTPS（企业微信必需）
重要：企业微信要求H5应用必须通过HTTPS访问。你需要配置SSL证书。
1安装 Nginx
sudo apt install -y nginx
2申请免费SSL证书
在腾讯云控制台 → SSL证书 → 申请免费证书（TrustAsia），验证域名后下载。
或使用 Let's Encrypt 自动申请：
sudo apt install -y certbot python3-certbot-nginx
sudo certbot --nginx -d app.你的域名.com
3配置 Nginx 反向代理
sudo nano /etc/nginx/conf.d/fire-window.conf
写入以下配置（替换域名和证书路径）：
server {
listen 80;
server_name app.你的域名.com;
return 301 https://$host$request_uri;
}
server {
listen 443 ssl;
server_name app.你的域名.com;
ssl_certificate /etc/nginx/ssl/你的域名.pem;
ssl_certificate_key /etc/nginx/ssl/你的域名.key;
location / {
proxy_pass http://127.0.0.1:3000;
proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection 'upgrade';
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
proxy_cache_bypass $http_upgrade;
}
}
重载 Nginx：
sudo nginx -t
sudo systemctl reload nginx
验证：浏览器访问 https://app.你的域名.com，能看到系统首页即部署成功！
第四步：企业微信后台配置
2创建自建应用
- 进入 「应用管理」 → 「自建」 → 点击 「创建应用」
- 填写应用信息：
- 应用名称：瑞格防火玻璃项目管理平台
- 应用logo：上传一个图标（可用公司logo）
- 应用介绍：瑞格防火玻璃项目管理平台
- 可见范围：选择需要使用的部门/员工
- 点击「创建」
3配置应用主页
在应用详情页 → 「开发者接口」 → 「网页授权及JS-SDK」：
| 配置项 | 填写内容 |
|---|
| 可信域名 | app.你的域名.com |
| 应用主页 | https://app.你的域名.com |
| 回调域名 | app.你的域名.com |
注意：域名必须与SSL证书一致，且已完成ICP备案。
4（可选）配置企业微信授权登录
如需获取员工身份（谁录入的合同/进度），可配置OAuth登录：
- 在应用详情页记录 AgentId 和 Secret
- 在「企业信息」页面记录 CorpID
- 后续可在 server.js 中添加OAuth接口实现免登
5设置工作台展示
- 在应用详情页 → 「工作台应用主页」
- 设置自定义展示内容（可选）
- 开启「在聊天工具栏中展示」（可选）
第五步：员工使用
完成！员工只需在企业微信中：
- 打开企业微信 → 底部「工作台」
- 找到「瑞格防火玻璃项目管理平台」应用图标
- 点击即可打开系统，开始使用
多人协作说明：
- 所有数据存储在服务器上，多人共享同一份数据
- 每次操作后数据自动保存到服务器
- 点击右上角「🔄 刷新」可拉取最新数据
- 建议不同人员负责不同模块（如：销售管合同、采购管采购、厂长管生产、财务管财务）
常见问题
Q: 域名还没备案怎么办？
A: 可以先用服务器IP地址在本地浏览器测试。企业微信正式上线需要已备案域名。备案通常需要7-15个工作日。
Q: 服务器需要什么配置？
A: 2核2GB足够。系统是轻量级应用，不需要数据库服务器，数据存储在JSON文件中。
Q: 数据安全吗？
A: 建议定期备份 server-data.json 文件。可设置定时任务自动备份：
crontab -e
0 3 * * * cp /opt/app/server-data.json /opt/app/backup/data-$(date +\%Y\%m\%d).json
Q: 可以在手机上用吗？
A: 可以！企业微信支持手机端，系统已做移动端适配，在手机企业微信里打开即可使用。
Q: 后续如何升级功能？
A: 修改 app.html 和 server.js 后，重新上传到服务器，重启 Node.js 进程即可（pm2 restart fire-window-system）。