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

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

2025-05-10 15:47:26作者:霍妲思

部署准备与常见问题解决

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:apppassword@smtp.gmail.com:587
SET MAIL_FROM="Wekan通知 <user@domain.com>"

版本兼容性与升级建议

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

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

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

功能扩展与使用技巧

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

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

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

登录后查看全文
热门项目推荐
相关项目推荐