自托管看板工具BanBan

发表于 2025-02-03 更新于 2025-10-28 分类于各种折腾 Waline：阅读次数：本文字数： 2.2k 阅读时长 ≈ 2 分钟

BanBan 是一个自托管的看板工具。

简介

什么是 BanBan ？

BanBan 是一个自托管的看板工具，旨在帮助团队管理和跟踪任务。它允许用户通过可视化的方式组织工作流程，适合敏捷开发和项目管理。

关键特点

自托管：用户可以在自己的服务器上运行 BanBan，确保数据安全和隐私。
可视化管理：使用看板视图，用户可以轻松查看和管理任务的状态。
安装简便：通过 npm 安装，提供 Docker 支持，方便在生产环境中部署。
数据库支持：使用 Prisma 进行数据库迁移和管理。

BanBan 是一个灵活且功能强大的工具，适合希望提高工作效率的团队。

安装

在群晖上以 Docker 方式安装。

在注册表中搜索 banban ，选择第一个 m0gd0ck/banban，版本选择 latest。

本文写作时， latest 版本对应的软件版本为 0.1.0；

卷

在 docker 文件夹中，创建一个新文件夹 banban，并在其中建两个个子文件夹 db 和 storage

文件夹	装载路径	说明
`docker/banban/db`	`/app/prisma/db`	存放数据库
`docker/banban/storage`	`/app/storage`	存放上传文件

端口

本地端口不冲突就行，不确定的话可以用命令查一下

1 2	# 查看端口占用 netstat -tunlp \| grep 端口号

本地端口	容器端口
`3596`	`3000`

环境

可变	值	说明
`DATABASE_URL`	`file:./db/banban.db`	数据库的连接字符串，指定使用的数据库文件位置。
`PORT`	`3000`	应用程序监听的端口号，用于访问 `BanBan` 看板工具。
`NODE_ENV`	`production`	设置 `Node.js` 的环境模式，通常用于区分开发和生产环境。

DATABASE_URL：这个变量告诉应用程序从哪里获取数据库。如果使用 SQLite 数据库，通常会指定一个文件路径。
PORT：定义了应用程序运行时的端口，用户需要通过此端口访问 BanBan 的 web 界面。
NODE_ENV：区分不同环境的运行配置。设置为 production 时，应用会使用生产环境的配置，通常涉及性能优化和安全性设置。

命令行安装

如果你熟悉命令行，可能用 docker cli 更快捷

# 新建文件夹 banban 和 子目录
mkdir -p /volume1/docker/banban/{db,storage}

# 进入 banban 目录
cd /volume1/docker/banban

# 运行容器
docker run -d \
   --restart always \
   --name banban \
   -p 3596:3000\
   -v $(pwd)/db:/app/prisma/db \
   -v $(pwd)/storage:/app/storage \
   -e DATABASE_URL=file:./db/banban.db \
   -e PORT=3000 \
   -e NODE_ENV=production \
   m0gd0ck/banban:latest

也可以用 docker-compose 安装，将下面的内容保存为 docker-compose.yml 文件

version: '3.7'

services:
  banban:
    image: m0gd0ck/banban:latest
    container_name: banban
    restart: always
    environment:
      DATABASE_URL: file:./db/banban.db
      PORT: 3000
      NODE_ENV: production
    volumes:
      - ./db:/app/prisma/db
      - ./storage:/app/storage
    expose:
      - 3000
    ports:
      - '3596:3000'

然后执行下面的命令

# 新建文件夹 banban 和 子目录
mkdir -p /volume1/docker/banban/{db,storage}

# 进入 banban 目录
cd /volume1/docker/banban

# 将 docker-compose.yml 放入当前目录

# 一键启动
docker-compose up -d