Wekan项目Windows平台部署与运维指南

部署准备与常见问题解决

Wekan作为一款开源看板工具，在Windows平台部署时需要注意几个关键环节。首先需要确保系统已安装MongoDB数据库服务，这是Wekan运行的基础依赖。部署包应包含三个核心文件：node.exe执行环境、main.js主程序以及start-wekan.bat启动脚本。

在Windows PowerShell环境下执行时，必须使用".\"前缀调用批处理文件，这是PowerShell的安全策略限制。正确的启动命令应为：

.\start-wekan.bat

配置文件中需要特别注意ROOT_URL参数的设置，必须使用内网IP地址而非localhost，否则其他设备无法访问。典型配置示例如下：

SET ROOT_URL=http://192.168.0.54
SET PORT=2000

数据库管理与备份策略

Wekan使用MongoDB作为数据存储引擎，备份恢复需要使用MongoDB官方工具包中的mongodump和mongorestore命令。备份时需注意：

1. 在命令行直接执行mongodump会创建dump目录保存数据
2. 恢复时必须先停止Wekan服务
3. 恢复命令需要添加--drop参数以清空现有数据

典型备份恢复流程：

# 备份
.\mongodump.exe

# 恢复
.\mongorestore.exe --drop

邮件服务集成配置

Wekan支持通过SMTP协议集成邮件通知服务。以Gmail为例，配置时需要注意：

1. 必须使用应用专用密码而非常规密码
2. 587端口需要配合STARTTLS加密
3. 存在发送频率限制

标准配置模板：

SET MAIL_URL=smtp://username:[e-mail]:587
SET MAIL_FROM="Wekan通知 <[e-mail]>"

版本兼容性与升级建议

当前稳定版基于Meteor 2框架，配套的运行时环境有特定版本要求：

• Node.js 14.x
• MongoDB 6.x

升级到新版本运行时需谨慎，可能涉及框架迁移工作。建议在生产环境保持现有版本，待官方确认兼容性后再进行升级。

功能扩展与使用技巧

虽然当前版本暂不支持多工作区功能，但可以通过组织架构管理实现类似效果：

1. 在管理面板创建不同团队
2. 将用户分配到对应团队
3. 设置看板的团队访问权限

对于个人用户，建议合理使用标签和筛选功能来区分不同项目看板。系统默认采用"白名单"机制，新建看板需要手动添加成员才能可见，这种设计确保了数据隐私性。