🛠 宝塔面板部署指引

企业微信 × Notion 生产进度录入系统 — 全图形化操作

服务器信息：阿里云 ECS · IP: 47.114.92.201 · 宝塔面板已部署

1 安装 Node.js 版本管理器

宝塔需要先安装 Node.js 才能跑我们的程序：

软件商店 → 运行环境 → 搜索 "Node.js 版本管理器"
💡 Node.js 版本管理器自带 PM2：无需单独安装 PM2，后续启动应用直接用图形界面。

2 上传项目文件

用宝塔文件管理器上传项目：

文件 → 进入目录 /opt/wecom-notion-sync/

最终目录结构应该是：

/opt/wecom-notion-sync/ ├── server.js ├── package.json ├── .env ├── config/ │ └── roles.json └── public/ ├── index.html ├── css/style.css ├── js/app.js └── deploy.html, setup.html, baota.html
提示：在宝塔 "文件" 里上传压缩包更高效，上传后右键 → 解压

3 创建站点 + 反向代理 核心步骤

这是关键步骤——把域名指向我们的应用：

① 创建站点

网站 → 添加站点

② 设置反向代理

网站 → 找到刚创建的站点 → 设置 → 反向代理
💡 这样设置后：用户访问 https://你的域名/ → 宝塔 Nginx → 转发到本机 3000 端口 → 我们的 Node.js 程序

4 申请 SSL 证书

Let's Encrypt 免费证书，宝塔一键申请：

网站 → 站点 → 设置 → SSL
域名解析必须先指向服务器：申请 SSL 前，确认你的域名 A 记录已指向 47.114.92.201，否则 Let's Encrypt 验证会失败。

5 配置环境变量 + 启动应用

① 编辑 .env 文件

文件 → /opt/wecom-notion-sync/.env → 右键编辑

填入你的企微配置：

# 企微配置（从企微管理后台获取） WECOM_CORP_ID=ww你的企业ID WECOM_AGENT_ID=1000002 WECOM_SECRET=你的应用Secret # 域名（替换为你的实际域名） WECOM_REDIRECT_URI=https://progress.yourcompany.com/auth/wecom/callback # 生产模式（关闭演示） DEMO_MODE=false

② 启动 Node.js 应用

软件商店 → 已安装 → Node.js 版本管理器 → 设置 → 添加项目
启动后回到 Node.js 管理器列表，应该看到项目状态为 "运行中"，端口 3000 正在监听

6 配置企微可信域名 必做

让企微信任你的域名：

放置校验文件：

文件 → /opt/wecom-notion-sync/public/ → 上传校验文件

上传完成后访问 https://你的域名/WW_verify_xxx.txt 应能看到内容。

7 配置角色映射

编辑 /opt/wecom-notion-sync/config/roles.json 的 user_role_mapping：

"user_role_mapping": { "zhangsan": { "role": "production_planning", "name": "张三" }, "lisi": { "role": "production_tracking", "name": "李四" } }

userid 在企微管理后台 → 通讯录 → 点击成员 → 账号栏可见。

修改后在 Node.js 管理器点击 "重启"。

8 验证上线

最终验证清单：

🛠 日常运维（都在宝塔里完成）

# 查看应用日志 软件商店 → Node.js 版本管理器 → 点击项目 → "日志" # 修改配置后重启 文件 → 编辑 .env 或 roles.json Node.js 版本管理器 → 找到项目 → 重启 # SSL 证书自动续期 宝塔 SSL 自动续期，无需手动操作 # 看服务器资源占用 首页 → 实时监控 # 直接 SSH 命令（如果需要） 终端 → 输入命令回车

❓ 常见问题排查