Debian/Ubuntu安装Casnode论坛全攻略：含Flarum完整安装指南

2小时前更新

还在为搭建论坛掉头发？今天手把手教你用Casnode在Linux上快速建站！作为一个仿V2EX风格的开源论坛系统，Casnode凭借Golang+React的技术栈、Apache 2.0开源协议以及高度可定制性，成了不少中文开发者的建站首选。官方文档躺这儿：Casnode GitHub主页，适合需要轻量级社区、技术论坛或内部交流平台的场景。

一、Casnode到底是个啥？能用在哪？

Casnode可不是普通的论坛程序——它完美复刻了V2EX的界面和核心功能，但代码全自主可控！前端React+后端Golang（Beego框架+xorm），数据库兼容MySQL/PostgreSQL/SQLite等主流系统，自带中英文国际化支持。评论区直接写Markdown、拖拽传图（阿里云CDN加持）、Github/Google一键登录，这些功能开箱即用。拿它做技术社区、产品反馈站甚至资源分享平台都很香，Casnode官方论坛就是个活例子！

适用场景	优势
技术开发者社区	Markdown语法支持/代码高亮
产品用户反馈	分类标签/附件上传
企业内部交流	LDAP集成/权限控制

二、Debian/Ubuntu部署Casnode（附避坑指南）

1. 环境准备

确保系统已装好Docker和docker-compose，别偷懒跳过这步！

# 更新系统并安装依赖
sudo apt update && sudo apt upgrade -y
sudo apt install docker.io docker-compose git -y
# 避免权限报错
sudo usermod -aG docker $USER
newgrp docker

2. 拉取配置并启动

别自己从头写配置了，直接用优化版docker-compose：

git clone https://gitee.com/study-demo-all/casnode-bbs-docker-compose.git
cd casnode-bbs-docker-compose
docker-compose up -d

等命令跑完，三个容器就起来了：casdoor（权限管理）、casnode（论坛核心）、mysql8（数据库）。

3. 解决登录跳转的巨坑！

默认配置登录必失败！因为证书不匹配。赶紧替换JWT证书：

编辑casdoor-conf/app.conf，找到jwtPublicKey字段
替换为官方Demo证书（复制这段↓↓↓）

-----BEGIN CERTIFICATE-----
MIIE+TCCAuGgAwIBAgIDAeJAMA0GCSqGSIb3DQEBCwUAMDYxHTAbBgNVBAoTFENh
...（完整证书见GitHub）...
-----END CERTIFICATE-----

吐槽：这坑我踩了3小时！官方文档居然没强调，社区老哥的帖子救了我一命

4. 访问与初始化

Casdoor后台：http://服务器IP:8000 → 账号admin/密码123
Casnode论坛：http://服务器IP:7000

进后台第一件事：改密码！关手机验证！ 否则注册能烦死人（路径：应用管理→编辑应用→取消手机/邮箱必填）

三、Flarum完整安装教程（附伪静态配置）

如果你更倾向PHP论坛，Flarum的轻量化体验值得一试，但环境配置能逼疯新手！

1. 暴力解决依赖问题

PHP扩展一个都不能少，缺了fileinfo直接白屏！

# 安装PHP及扩展（以PHP7.4为例）
sudo apt install php7.4 php7.4-fpm php7.4-mysql php7.4-mbstring php7.4-curl php7.4-zip php7.4-gd php7.4-xml php7.4-fileinfo -y
# 修改php.ini
sudo sed -i 's/;extension=fileinfo/extension=fileinfo/g' /etc/php/7.4/fpm/php.ini
sudo systemctl restart php7.4-fpm

2. 命令行极速安装

# 进网站根目录
cd /var/www/html
# Composer拉取最新版（没装Composer？自行百度五分钟搞定）
composer create-project flarum/flarum . --stability=beta
# 权限设置（不然安装向导报错）
chmod -R 775 assets storage
chown -R www-data:www-data .

3. Nginx伪静态配置（宝塔党直接抄）

在站点配置里加入这段，否则页面404：

location / {
    try_files $uri $uri/ /index.php?$query_string;
}
location /api { 
    try_files $uri $uri/ /api.php?$query_string; 
}
location /admin { 
    try_files $uri $uri/ /admin.php?$query_string; 
}
location ~* \.php$ {
    include snippets/fastcgi-php.conf;
    fastcgi_pass unix:/var/run/php/php7.4-fpm.sock;
}

血泪提示： 用宝塔的，到网站设置→伪静态选Flarum模板，省得手敲！