Wekan 安装 Windows：最稳妥的本地部署方法详解

关键词

Wekan 安装 Windows、Wekan Windows 部署、Wekan Docker 安装、Wekan 看板工具

问题分析

Wekan 是一款开源的看板工具，功能和 Trello 类似，适合做任务管理、项目协作、个人待办整理。很多人搜“Wekan 安装 Windows”，其实真正要解决的通常有三种情况：

直接在 Windows 上跑起来，用于本地体验或轻量使用。
在 Windows 电脑上长期部署，作为局域网内可访问的看板服务。
遇到安装报错、启动失败、端口冲突、数据库连接异常等问题。

先说结论：
如果你是 Windows 用户，最推荐的安装方式是 Docker Desktop + Wekan 容器。这是目前最省事、最稳定、也最不容易把系统环境搞乱的方法。
如果你只是想快速体验，也可以用 Windows 子系统 Linux（WSL2）。
不建议直接在纯 Windows 环境里手动折腾 Node.js、MongoDB、环境变量那套老办法，麻烦多，兼容性也差。

解决方案

一、安装前准备

1. 系统要求

建议使用以下环境：

Windows 10 64 位或 Windows 11
8GB 内存以上更稳妥
开启虚拟化功能
保证磁盘空间至少 10GB 以上
能正常联网

2. 先检查虚拟化是否开启

Wekan 用 Docker 跑时，底层通常依赖 Hyper-V 或 WSL2。

你可以这样检查：

按 Ctrl + Shift + Esc 打开任务管理器。
切换到“性能”选项卡。
看右下角“虚拟化”是否显示“已启用”。

如果是“已禁用”，需要进 BIOS 打开：

Intel 平台一般叫 Intel Virtualization Technology
AMD 平台一般叫 SVM Mode

开启后保存退出，再进系统。

二、推荐安装方式：Docker Desktop 安装 Wekan

这是最适合大多数人的方式，后续维护也简单。

1. 安装 Docker Desktop

先安装 Docker Desktop：

去 Docker 官网下载 Docker Desktop for Windows。
安装时勾选使用 WSL2 后端。
安装完成后重启电脑。
打开 Docker Desktop，确认状态是 Running。

如果 Docker 启动时报错，通常是：

虚拟化没开
WSL2 没装好
Hyper-V 冲突
Windows 版本太旧

这些问题后面会专门说明。

2. 准备 Wekan 容器

Wekan 运行时需要数据库支持，常见搭配是：

wekan
mongo 数据库

如果你打算长期使用，建议一并配置数据持久化，不然容器删掉后数据也没了。

下面给出一个最实用的 docker-compose 方案。

3. 创建 `docker-compose.yml`

在 Windows 上新建一个文件夹，比如：

D:\wekan

然后在里面创建 docker-compose.yml，内容如下：

version: "3.8"

services:
  mongo:
    image: mongo:5
    container_name: wekan-mongo
    restart: unless-stopped
    command: mongod --oplogSize 128
    volumes:
      - mongo_data:/data/db

  wekan:
    image: wekanteam/wekan
    container_name: wekan-app
    restart: unless-stopped
    ports:
      - "8080:8080"
    environment:
      - MONGO_URL=mongodb://mongo:27017/wekan
      - ROOT_URL=http://localhost:8080
      - MAIL_URL=
      - WITH_API=true
    depends_on:
      - mongo

volumes:
  mongo_data:

4. 启动 Wekan

打开 PowerShell，进入该目录：

cd D:\wekan

然后执行：

docker compose up -d

如果你的 Docker 版本较旧，也可能需要：

docker-compose up -d

等待几分钟，首次拉取镜像会慢一些。

启动完成后，在浏览器打开：

http://localhost:8080

如果页面正常显示，说明 Wekan 已经跑起来了。

三、首次登录与基本配置

Wekan 第一次打开时，通常要先创建管理员账号。

常见步骤：

打开网页。
注册第一个账号。
这个账号会成为管理员。
登录后创建团队、看板、列表和任务卡片。

如果你要让局域网其他设备访问这台 Wekan，需要把 ROOT_URL 改成你的电脑局域网 IP，例如：

- ROOT_URL=http://192.168.1.100:8080

然后重启容器：

docker compose down
docker compose up -d

四、常见安装问题和处理方法

1. Docker Desktop 无法启动

常见原因：

虚拟化没开
WSL2 没装好
Windows 版本过低
Hyper-V 被其他虚拟机软件冲突

处理办法：

检查任务管理器里的虚拟化状态。
在“启用或关闭 Windows 功能”里勾选：
- 适用于 Linux 的 Windows 子系统
- 虚拟机平台
重启电脑。
再启动 Docker Desktop。

2. `docker compose up -d` 报端口占用

如果 8080 被别的软件占用了，比如其他 Web 服务、代理软件、开发工具，就会启动失败。

处理方法：

把端口改掉，例如改成 8081：

ports:
  - "8081:8080"

然后访问：

http://localhost:8081

3. 页面能打开，但登录失败或报数据库错误

大概率是 Mongo 容器没正常工作，或者数据库数据异常。

排查命令：

docker ps
docker logs wekan-mongo
docker logs wekan-app

重点看有没有：

connection refused
authentication failed
MongoNetworkError
duplicate key
fatal

如果是第一次部署，最直接的办法是删掉容器和数据卷重来。

谨慎操作，删除数据卷会清空看板数据：

docker compose down -v
docker compose up -d

4. 打不开 `localhost:8080`

可能原因：

容器还没启动完
防火墙拦截
Docker 网络异常
端口映射写错

排查顺序：

先看 docker ps，确认 wekan-app 和 wekan-mongo 都在运行。
再看 docker logs wekan-app。
检查 docker-compose.yml 的端口映射。
确认浏览器访问的是 http://localhost:8080，不是 https://。

五、WSL2 方式安装 Wekan

如果你不想用 Docker Desktop 也可以走 WSL2，但步骤更适合进阶用户。

思路是：

开启 WSL2。
安装 Ubuntu。
在 Ubuntu 里装 Docker。
再部署 Wekan。

这种方式灵活，但比 Docker Desktop 更折腾，适合已经熟悉 Linux 的人。

基本流程如下：

wsl --install

安装完 Ubuntu 后，在 Ubuntu 里执行：

sudo apt update
sudo apt install docker.io docker-compose -y

然后再创建 Wekan 的 docker-compose.yml，启动方式和前面一样。

如果你的目标只是“Windows 上把 Wekan 跑起来”，没必要优先选这个方案。

六、Wekan 适合什么场景

Wekan 在下面这些场景里很实用：

个人任务管理
小团队项目协作
家庭待办清单
局域网内部任务看板
自建轻量级工作流系统

它的优点是开源、免费、可自部署。
缺点是界面和生态不如商业产品成熟，企业级深度集成能力有限。

如果你只是想用一个稳定、轻量、能自己掌控数据的看板系统，Wekan 是合适的。

七、部署后的优化建议

1. 开机自启

Docker 的 restart: unless-stopped 已经能保证容器在 Docker 服务重启后自动拉起。
如果你想更稳，可以把 Docker Desktop 设为开机启动。

2. 备份数据

Wekan 最重要的是 MongoDB 数据。
如果你长期使用，建议定期备份数据卷，避免误删或系统故障导致数据丢失。

3. 局域网访问

如果你要给同一网络下的其他电脑访问，记得：

改 ROOT_URL
在 Windows 防火墙里放行 8080 端口
确保访问地址是你本机局域网 IP，不是 localhost

4. 远程访问

如果你打算放到公网，必须额外做：

反向代理
HTTPS 证书
强密码
访问控制
防火墙规则

不建议直接裸露 8080 端口到公网。

注意事项

不要直接在生产环境里随便删容器。
没做数据卷映射的话，重建容器可能会丢数据。
不要把 Wekan 和 MongoDB 随便混装到系统环境里。
Docker 方式更干净，也更容易回滚。
ROOT_URL 要和实际访问地址一致。
否则登录、跳转、回调可能会出问题。
Windows Defender 或第三方杀毒软件可能干扰 Docker。
如果容器反复异常退出，要检查防火墙和安全软件策略。
如果只是学习或测试，推荐先用本地 8080 端口。
先把功能跑通，再考虑局域网共享和公网部署。

总结

在 Windows 上安装 Wekan，最稳妥的方案是 Docker Desktop + docker-compose。
这个方案的核心优势是部署简单、环境干净、出问题容易排查，而且后续迁移也方便。对大多数 Windows 用户来说，这比直接手动装 MongoDB 和 Node.js 靠谱得多。

如果按上面的流程操作，基本可以做到：