4、看板环境搭建：安装WeKan、配置Docker环境、初始化看板项目

说实话，很多团队学看板方法学得挺好，一到落地就卡住了。卡在哪？环境搭建。要么是服务器权限不够，要么是依赖冲突装到一半崩了。我见过最夸张的，一个团队花了两周装WeKan，最后发现装错了版本。

这一章，咱们就把这事彻底搞定。你跟着我的步骤走，半小时内就能看到一个跑起来的看板系统。

4.1 为什么选WeKan + Docker？

看板工具不少，Trello、Jira、物理白板都行。但咱们做实战课程，得选一个免费、轻量、能自己掌控数据的。WeKan正好满足这三点。

至于Docker——说白了，就是把你应用和它需要的环境打包成一个“集装箱”。你想想看，换台服务器，不用重新装数据库、配依赖，直接拉镜像跑起来就行。我在项目中遇到过好几次，开发环境好好的，一上测试服务器就报错，后来全切Docker，再没出过这种问题。

4.2 安装Docker环境

嗯，这里要注意。Docker的安装方式取决于你的操作系统。我按最常见的三种情况来说。

4.2.1 Linux（Ubuntu/Debian）

我个人习惯用Ubuntu Server做生产环境。命令很简单，直接贴给你：

# 更新包索引
sudo apt update

# 安装依赖
sudo apt install apt-transport-https ca-certificates curl software-properties-common

# 添加Docker官方GPG密钥
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo apt-key add -

# 添加稳定版仓库
sudo add-apt-repository "deb [arch=amd64] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable"

# 安装Docker
sudo apt update
sudo apt install docker-ce

# 验证安装
sudo docker --version

装完之后，记得把当前用户加入docker组，不然每次都要sudo：

sudo usermod -aG docker $USER
# 退出重新登录，或者执行 newgrp docker 刷新组

4.2.2 macOS

macOS用户直接下载Docker Desktop就行。去官网下载dmg文件，拖到Applications里。装完打开，等小鲸鱼图标亮起来就OK了。

我曾经帮一个同事排查问题，他装完Docker Desktop一直起不来。后来发现是没开虚拟化。你如果遇到类似情况，去「系统偏好设置 → 隐私与安全性 → 允许」里看看权限。

4.2.3 Windows

Windows分两种情况：

• Windows 10/11 Pro或Enterprise：装Docker Desktop，启用WSL 2后端。性能好，兼容性强。
• Windows Home：装Docker Toolbox（老版本），或者升级到Pro。我个人不建议在Home版上折腾，坑太多。

4.3 安装WeKan

Docker装好了，接下来就是拉WeKan镜像。这一步其实就一行命令：

docker run -d --restart=always --name wekan \
  -p 8080:8080 \
  -e MONGO_URL="mongodb://wekan:wekan@mongo:27017/wekan?authSource=admin" \
  -e ROOT_URL="http://localhost:8080" \
  wekan/wekan

等等，这里有个问题。WeKan依赖MongoDB，你直接跑上面这条命令会报错，因为mongo容器还没启动。正确的做法是先启动MongoDB，再启动WeKan。

我建议你用Docker Compose来管理，这样两个容器一起启动，省心：

# 创建项目目录
mkdir wekan-project && cd wekan-project

# 创建 docker-compose.yml 文件
nano docker-compose.yml

写入以下内容：

version: '3'

services:
  mongo:
    image: mongo:5.0
    container_name: wekan-mongo
    restart: always
    environment:
      MONGO_INITDB_ROOT_USERNAME: wekan
      MONGO_INITDB_ROOT_PASSWORD: wekan
    volumes:
      - mongo-data:/data/db

  wekan:
    image: wekan/wekan:latest
    container_name: wekan-app
    restart: always
    ports:
      - "8080:8080"
    environment:
      MONGO_URL: "mongodb://wekan:wekan@mongo:27017/wekan?authSource=admin"
      ROOT_URL: "http://localhost:8080"
    depends_on:
      - mongo

volumes:
  mongo-data:

保存退出后，执行：

docker-compose up -d

等一两分钟，打开浏览器访问 http://localhost:8080，你应该能看到WeKan的登录页面了。

4.4 初始化看板项目

WeKan跑起来了，但里面是空的。咱们得创建一个真正的看板项目。我带你走一遍初始化流程。

4.4.1 注册管理员账号

打开WeKan页面，点击「注册」。填用户名、邮箱、密码。第一个注册的用户会自动成为管理员。

这里有个细节——WeKan默认开启了注册功能。如果是生产环境，我建议注册完管理员后，立刻关闭公开注册。怎么关？进「管理面板 → 设置 → 禁用注册」。

4.4.2 创建第一个看板

登录后，点击左上角的「+ 新建看板」。输入看板名称，比如「研发团队看板」。模板选「空白看板」就行，咱们后面自己配列。

创建完成后，你会看到一个默认的三列看板：

列名	默认用途	说明
待办	待处理的任务	所有新任务默认放这里
进行中	正在执行的任务	团队成员当前的工作项
已完成	已完成的任务	归档前暂存

这三列是最基础的看板结构。你想想看，实际工作中肯定不止这三列。比如测试团队可能需要「待测试」、「测试中」、「已测试」。别急，后面章节我会详细讲怎么设计列。

4.4.3 添加第一个卡片

点击「待办」列下方的「+ 添加卡片」。输入标题，比如「搭建WeKan环境」。点保存。

卡片创建后，你可以：

• 拖拽：把卡片从「待办」拖到「进行中」
• 点开：查看详情，添加描述、标签、成员、截止日期
• 评论：在卡片底部写评论，@成员通知他

嗯，这里要注意。WeKan的卡片操作逻辑和Trello很像，但有些细节不同。比如标签颜色，WeKan默认只有几种，你可以进管理面板自定义。

4.5 验证环境是否正常

初始化完成后，我建议你做几个快速验证：

1. 创建5张测试卡片，分别拖到不同列
2. 修改一张卡片的描述，加个附件（随便传个txt文件）
3. 邀请一个测试成员（可以用另一个邮箱注册）
4. 刷新页面，确认数据没丢

如果以上都正常，恭喜你，环境搭建成功了。

4.6 本章知识体系

下面这张图帮你梳理了本章的核心逻辑：

从这张图你能看到，整个搭建流程是线性的：先搞定Docker，再装WeKan，最后初始化项目。每一步都有明确的输入和输出。我建议你按这个顺序来，别跳步。