Debian/Ubuntu手动部署Casnode论坛实战指南：告别Docker依赖！

一、Casnode是什么？适合什么场景？

Casnode是一款仿V2EX风格的开源论坛系统，采用Golang(后端)+React(前端)技术栈，专为需要高性能社区平台的场景设计。它完美适配：

• 开发者技术交流社区
• 产品用户反馈中心
• 企业内部知识论坛
• 开源项目支持论坛

核心优势

• 🚀 Golang编写，天生高并发
• 🔐 集成Casdoor统一认证
• 📝 Markdown原生支持
• 🌍 多语言国际化
• 🔌 丰富的API接口

二、环境准备：装好这些才能玩得转

1. 系统要求

• Debian 10+ 或 Ubuntu 18.04+
• 2核CPU/4GB内存（实测低于此配置编译会卡死）
• 干净的sudo权限用户

2. 安装基础依赖

# 更新系统
sudo apt update && sudo apt upgrade -y

# 安装编译工具链
sudo apt install -y build-essential git curl wget

# 安装数据库（MySQL为例）
sudo apt install -y mysql-server mysql-client

三、手动部署Casnode全流程

1. 安装Golang环境（版本≥1.16）

# 下载最新版Go
wget https://golang.org/dl/go1.20.5.linux-amd64.tar.gz

# 解压到/usr/local
sudo tar -C /usr/local -xzf go1.20.5.linux-amd64.tar.gz

# 设置环境变量
echo "export PATH=$PATH:/usr/local/go/bin" >> ~/.bashrc
echo "export GOPATH=$HOME/go" >> ~/.bashrc
source ~/.bashrc

# 验证安装
go version

2. 安装Node.js环境（版本≥14）

# 使用NodeSource仓库
curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash -
sudo apt install -y nodejs

# 验证安装
node -v
npm -v

3. 配置MySQL数据库

# 安全初始化
sudo mysql_secure_installation

# 登录MySQL
sudo mysql -u root -p

# 创建数据库和用户
CREATE DATABASE casnode DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
CREATE USER 'casnode_user'@'localhost' IDENTIFIED BY 'StrongPassword123!';
GRANT ALL PRIVILEGES ON casnode.* TO 'casnode_user'@'localhost';
FLUSH PRIVILEGES;
EXIT;

4. 编译安装Casnode后端

# 克隆源码
git clone https://github.com/casbin/casnode.git
cd casnode

# 安装依赖
go mod download

# 修改配置文件
cp conf/app.conf.example conf/app.conf
nano conf/app.conf

关键配置项：

httpport = 7000
driverName = mysql
dataSourceName = casnode_user:StrongPassword123@tcp(127.0.0.1:3306)/casnode

# 邮件配置（必须正确设置否则无法注册）
smtpPort = 587
smtpServer = smtp.yourprovider.com
smtpUsername = your@email.com
smtpPassword = your_email_password

5. 编译前端资源

cd web
npm install
npm run build
cd ..

6. 启动Casnode服务

# 编译后端
go build -o casnode

# 首次运行初始化数据库
./casnode

# 设置系统服务
sudo nano /etc/systemd/system/casnode.service

服务文件内容：

[Unit]
Description=Casnode Forum Service
After=network.target mysql.service

[Service]
Type=simple
User=casnode
WorkingDirectory=/path/to/casnode
ExecStart=/path/to/casnode/casnode
Restart=always
RestartSec=30

[Install]
WantedBy=multi-user.target

# 启用服务
sudo systemctl daemon-reload
sudo systemctl enable casnode
sudo systemctl start casnode

四、安装Casdoor认证系统（必须！）

1. 安装依赖

sudo apt install -y openjdk-17-jdk maven

2. 编译安装Casdoor

git clone https://github.com/casdoor/casdoor.git
cd casdoor
mvn clean package -DskipTests

3. 配置Casdoor

cp conf/app.conf.example conf/app.conf
nano conf/app.conf

关键配置：

httpport = 8000
driverName = mysql
dataSourceName = casnode_user:StrongPassword123@tcp(127.0.0.1:3306)/casdoor

# 必须与Casnode配置一致！
jwtSecret = your_jwt_secret_key

4. 启动Casdoor服务

# 初始化数据库
java -jar target/casdoor-*.jar

# 创建系统服务
sudo nano /etc/systemd/system/casdoor.service

[Unit]
Description=Casdoor Authentication Service
After=network.target mysql.service

[Service]
Type=simple
User=casdoor
WorkingDirectory=/path/to/casdoor
ExecStart=/usr/bin/java -jar /path/to/casdoor/target/casdoor-*.jar
Restart=always
RestartSec=30

[Install]
WantedBy=multi-user.target

# 启用服务
sudo systemctl daemon-reload
sudo systemctl enable casdoor
sudo systemctl start casdoor

五、避坑专区：我踩过的雷你别踩

# 使用Gmail示例配置
smtpServer = smtp.gmail.com
smtpPort = 587
smtpUsername = your@gmail.com
smtpPassword = your_app_password  # 不是邮箱密码！
enableEmailAuth = true

# 前端构建
cd web
npm run build
cp -r build ../ # 将构建产物复制到后端目录

六、性能优化：让论坛飞起来

1. 启用Redis缓存

sudo apt install redis-server

在conf/app.conf中添加：

cacheConfig = redis://localhost:6379

2. Nginx反向代理配置

# Casnode配置
server {
    listen 80;
    server_name forum.yourdomain.com;
    
    location / {
        proxy_pass http://localhost:7000;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
    }
}

# Casdoor配置
server {
    listen 80;
    server_name sso.yourdomain.com;
    
    location / {
        proxy_pass http://localhost:8000;
        proxy_set_header Host $host;
    }
}

3. 数据库优化

# 登录MySQL
mysql -u root -p

# 优化配置
SET GLOBAL innodb_buffer_pool_size = 1G;
SET GLOBAL max_connections = 500;
SET GLOBAL thread_cache_size = 50;

七、维护与升级指南

1. 日常维护命令

# 查看服务状态
sudo systemctl status casnode
sudo systemctl status casdoor

# 查看日志
journalctl -u casnode -f
tail -f /path/to/casnode/logs/casnode.log

2. 升级Casnode步骤

cd /path/to/casnode
git pull origin master
go build -o casnode
sudo systemctl restart casnode

cd web
npm install
npm run build

八、最终效果与资源汇总

成功部署后：

• 论坛地址：http://your-server-ip:7000
• 后台管理：http://your-server-ip:8000 (默认账号:admin/123)