bbs-go v4.3.6：前端统一到 React Router，Docker 一键部署闭环

bbs-go 是一个用 Go 写的社区论坛系统，过去它的前端一直处于"分裂"状态——站点页面用 Nuxt、管理后台单独一个项目，部署和维护都要分别处理。v4.3.6 把这些碎片收拢了：前端统一迁移到 React Router Framework Mode，管理后台合并进同一个项目，旧的 Nuxt 和独立 admin 项目被移除。同时 Docker 部署形成了完整闭环，安装体验也做了针对性优化。对想快速搭一个论坛的人来说，现在是最省事的版本。

前端架构：从三个项目到一个

之前 bbs-go 的前端有三块东西：

• site/ — Nuxt 驱动的站点页面（帖子列表、详情、用户主页等）
• admin/ — 独立的管理后台项目
• server/ — Go 后端，同时内嵌了一些模板渲染

这套组合的问题很明显：两套前端框架意味着两套构建流程、两套依赖管理、两套部署配置。Nuxt 和 React 的生态差异也让组件复用几乎不可能。

v4.3.6 新增了 web/ 目录，基于 React Router Framework Mode 构建，把站点页面和管理后台统一承载在一个项目里。旧的 site/ 和 admin/ 直接移除，不再维护。

React Router Framework Mode 的好处在于它支持 SSR 和 CSR 的混合渲染——论坛的帖子详情页需要 SEO，可以用 SSR；管理后台不需要搜索引擎索引，纯 CSR 就够了，同一个项目里按路由区分渲染策略就行。

Docker 部署闭环

这个版本最实用的改进是 Docker 部署真正形成了闭环。之前用 Docker 跑 bbs-go，往往还需要手动处理数据库初始化、配置文件生成、前端构建产物放置等步骤。v4.3.6 把这些环节都收进了容器编排里。

下面是一个可以直接用的 Docker Compose 配置，适合本地测试或小规模部署：

# docker-compose.yml
version: "3.8"

services:
  bbs-go:
    image: mlogclub/bbs-go:latest
    container_name: bbs-go
    restart: unless-stopped
    ports:
      - "8082:8082"
    environment:
      # 数据库连接 — 根据你的环境修改
      BBS_GO_DB_HOST: mysql
      BBS_GO_DB_PORT: 3306
      BBS_GO_DB_NAME: bbsgo
      BBS_GO_DB_USER: bbsgo
      BBS_GO_DB_PASS: bbsgo_password
      # Redis
      BBS_GO_REDIS_HOST: redis
      BBS_GO_REDIS_PORT: 6379
      # 站点基础配置
      BBS_GO_SITE_HOST: http://localhost:8082
    depends_on:
      - mysql
      - redis

  mysql:
    image: mysql:8.0
    container_name: bbs-go-mysql
    restart: unless-stopped
    environment:
      MYSQL_ROOT_PASSWORD: root_password
      MYSQL_DATABASE: bbsgo
      MYSQL_USER: bbsgo
      MYSQL_PASSWORD: bbsgo_password
    volumes:
      - mysql_data:/var/lib/mysql
    command: --character-set-server=utf8mb4 --collation-server=utf8mb4_unicode_ci

  redis:
    image: redis:7-alpine
    container_name: bbs-go-redis
    restart: unless-stopped
    volumes:
      - redis_data:/data

volumes:
  mysql_data:
  redis_data:

启动命令：

# 克隆项目（可选，如果只需要跑 Docker 可以跳过）
git clone https://github.com/mlogclub/bbs-go.git

# 直接用 Docker Compose 启动
docker compose up -d

# 查看日志确认启动状态
docker compose logs -f bbs-go

# 首次启动后，访问管理后台初始化站点配置
# 浏览器打开 http://localhost:8082/admin

几点注意事项：

• BBS_GO_SITE_HOST 要改成你实际的域名或 IP，否则站内生成的链接会指向 localhost。
• MySQL 的字符集必须设为 utf8mb4，论坛内容少不了 emoji 和中文。
• 如果是生产部署，给 MySQL 和 Redis 的密码换成强密码，别用示例里的弱密码。

安装体验优化

v4.3.6 对首次安装的流程做了简化。之前跑起来之后还要手动建表、导入初始数据、配置站点参数。新版本在启动时会自动检测数据库状态，未初始化时引导你进入配置页面完成设置，减少了"看文档猜步骤"的环节。

管理后台迁移到 React Router 项目后，后台的访问路径也统一了——不再需要单独部署一个 admin 服务，站点和管理后台共用同一个前端构建产物，通过路由区分 /admin 和普通页面。

迁移建议和取舍

如果你已经在跑旧版 bbs-go，升级到 v4.3.6 需要注意几件事：

一个务实的升级路径：先在本地用 Docker Compose 跑一套 v4.3.6，确认数据库迁移和功能正常，再替换生产环境。如果你没有深度定制过 Nuxt 前端，升级基本是无痛的——数据层没有大变动，主要是前端架构切换。

React Router 统一前端意味着以后社区贡献的组件只需要适配一套框架，这对长期维护是个利好。代价是如果你团队只熟悉 Vue/Nuxt，需要投入一点 React 学习成本。不过 React Router Framework Mode 的路由约定比较直观，从 Nuxt 迁移过来的心智负担不算大——都是文件系统路由，目录结构即路由结构。