
本文將記錄筆者在部署和使用Wekan(作為個(gè)人看板)中遇到的一些問(wèn)題和解決的方法。一來(lái),方便以后筆者本人再次部署或者遇到同樣的問(wèn)題;再者,可以給打算使用Wekan但是又不知從何起手的人做一個(gè)參考。如果你的英文足夠好,還是建議參考Wekan的文檔。
本文將講述如何將Wekan部署到服務(wù)器上,如果你想部署到樹(shù)莓派上可以參考筆者的另一篇文章:將免費(fèi)開(kāi)源看板軟件Wekan部署到樹(shù)莓派4B
本文將結(jié)合筆者在實(shí)際使用中的經(jīng)驗(yàn)介紹:
- Wekan的安裝部署(Docker)
- Wekan模板的使用
- Wekan規(guī)則的使用
Wekan 是啥?
Wekan在GitHub上的介紹:
Wekan is an completely Open Source and Free software collaborative kanban board application with MIT license.
Whether you’re maintaining a personal todo list, planning your holidays with some friends, or working in a team on your next revolutionary idea, Kanban boards are an unbeatable tool to keep your things organized. They give you a visual overview of the current state of your project, and make you productive by allowing you to focus on the few items that matter the most.
Since Wekan is a free software, you don’t have to trust us with your data and can install Wekan on your own computer or server. In fact we encourage you to do that by providing one-click installationde on various platforms.
簡(jiǎn)單地說(shuō),Wekan是一款遵循MIT協(xié)議完全開(kāi)源的協(xié)作看板軟件。它支持基于卡片的任務(wù)和待辦事項(xiàng)管理,同時(shí)還允許多用戶(hù)協(xié)同使用。你可以自由地將Wekan部署到你自己的計(jì)算機(jī)或者服務(wù)器(也可以部署在樹(shù)莓派上哦~)然后使用它。官方Demo:鏈接。支持的平臺(tái):鏈接。Wekan的功能特性:鏈接。

安裝&初始化
Docker (無(wú)自動(dòng)更新)
Keep backups, Docker is more complex than others above. Use only if you have time to test new release first, and it's critical nothing gets broken. Because Docker does not have automatic updates, please keep behind firewall, without any ports open to Internet, because Wekan gets new security etc updates to Node.js and other dependencies often.
根據(jù)官方的提示,「僅在能經(jīng)常測(cè)試新版的情況下使用」,因?yàn)?strong>「Docker沒(méi)有自動(dòng)更新」,而Wekan依賴(lài)的庫(kù)可能經(jīng)常需要安全更新。筆者目前是使用Docker來(lái)部署的,一開(kāi)始用docker安裝是覺(jué)得用docker部署只用改改配置文件,現(xiàn)在看來(lái)更麻煩,估計(jì)很快就會(huì)轉(zhuǎn)移到snap。接下來(lái),就來(lái)講講如何用Docker來(lái)部署Wekan吧。Wekan的Docker版安裝文檔:鏈接
安裝環(huán)境
OS: Ubuntu 18.04 bionic
Kernel: x86_64 Linux 4.15.0-99-generic
安裝docker
略...
下載docker-compose.yml
如果你沒(méi)有wget,先安裝wget:
sudo apt update
sudo apt install wget
接下來(lái),用wget下載配置文件:
wget https://raw.githubusercontent.com/wekan/wekan/master/docker-compose.yml
修改docker-compose.yml
其實(shí)在docker-compose.yml里,對(duì)于每個(gè)對(duì)應(yīng)的設(shè)置都有很想詳盡的描述.
這里提一下幾個(gè)重要的配置:
-
portsports: # Docker outsideport:insideport. Do not add anything extra here. # For example, if you want to have wekan on port 3001, # use 3001:8080 . Do not add any extra address etc here, that way it does not work. # remove port mapping if you use nginx reverse proxy, port 8080 is already exposed to wekan-tier network - 80:8080冒號(hào)前為外部端口,冒號(hào)后為內(nèi)部端口,如果你想改變端口號(hào),比如3001,那么只需要改成
3001:8080即可 -
root_urlenvironment: - MONGO_URL=mongodb://wekandb:27017/wekan #--------------------------------------------------------------- # ==== ROOT_URL SETTING ==== # Change ROOT_URL to your real Wekan URL, for example: # If you have Caddy/Nginx/Apache providing SSL # - https://example.com # - https://boards.example.com # This can be problematic with avatars https://github.com/wekan/wekan/issues/1776 # - https://example.com/wekan # If without https, can be only wekan node, no need for Caddy/Nginx/Apache if you don't need them # - http://example.com # - http://boards.example.com # - http://192.168.1.100 <=== using at local LAN - ROOT_URL=http://localhost # <=== using only at same laptop/desktop where Wekan is installed如果只在本地使用那么就不用更改,
ROOT_URL=http://localhost.例如使用默認(rèn)設(shè)置,那么使用http://localhost就能訪問(wèn)Wekan。如果像上面的例子將端口改為了3001,那么就需要設(shè)置ROOT_URL=http://localhost:3001。如用要在外部訪問(wèn)或者通過(guò)域名訪問(wèn),也是如此,以此類(lèi)推。參考:鏈接 -
關(guān)于郵箱系統(tǒng)
參考:鏈接
由于筆者是將Wekan做個(gè)人看版使用,所以不需要郵箱系統(tǒng)。在配置文件中刪掉或者注釋掉
MAIL_URL和MAIL_FROM即可。
運(yùn)行
在docker-compose.yml所在的目錄下:
-
前臺(tái)運(yùn)行
docker-compose up #啟動(dòng) docker-compose stop #停止 -
后臺(tái)運(yùn)行(無(wú)輸出)
docker-compose up -d #啟動(dòng) 下面兩行為啟動(dòng)成功的提示 Starting wekan-db ... done Recreating wekan-app ... done docker-compose stop #停止
啟動(dòng)完成后,用瀏覽器訪問(wèn)對(duì)應(yīng)的網(wǎng)址即可。第一個(gè)注冊(cè)的賬號(hào)為管理員賬號(hào)。可在“點(diǎn)擊頭像”-“選擇掛管理面板”打開(kāi)管理面板對(duì)Wekan進(jìn)行設(shè)置。如果只做個(gè)人使用,建議勾選禁止自主注冊(cè)。

Snap(有自動(dòng)更新)
Snap for Linux, install to your own server or laptop. Automatic Updates. Only Standalone Wekan.
If on Snap Stable automatic update breaks something, report Wekan for Snap bugs and feature requests here, so it can be fixed on some automatic update. If security is critical, keep behind firewall, without any ports open to Internet.
那么就等筆者用snap再次部署的時(shí)候再更新吧...
模板的使用
參看:鏈接
模板設(shè)置
模板設(shè)置入口
卡片模板設(shè)置
直接添加卡片即可

看板模板設(shè)置
添加后點(diǎn)文件夾圖標(biāo)即可進(jìn)入編輯狀態(tài)。

模板示例
接下分享一下筆者個(gè)人在用的模板
每月模板(看板模板)

建議在設(shè)計(jì)模板的時(shí)候就把標(biāo)簽和規(guī)則設(shè)置好:

注意
當(dāng)你使用模板時(shí),如果用到了標(biāo)簽,需要你的看板里的標(biāo)簽和模板里的標(biāo)簽一致,標(biāo)簽才會(huì)顯示。
規(guī)則
自動(dòng)記錄開(kāi)始時(shí)間

自動(dòng)記錄結(jié)束時(shí)間

本文首發(fā)于 Wulu's Blog
原文鏈接:免費(fèi)開(kāi)源看板軟件Wekan安裝與使用記錄