AsmBB 是一款由汇编语言编写的轻量级论坛引擎，基于 SQLite 数据库，并通过 FastCGI 接口与 Web 服务器通信。
官方提供了预编译的二进制包，开箱即用，非常适合在个人 VPS 上自托管。本文记录在 Debian 13 的环境下部署 AsmBB 并配置 Nginx 访问的具体步骤。
Debian 13 下 Nginx 的安装与配置可参考 此说明 ，本文不再赘述。
sudo apt update && sudo apt install wget curl tar unzip vim sqlite3 -y
创建网站目录：
sudo mkdir -p /var/www/asmbb && cd $_
下载并解压官方预编译二进制软件包：
sudo wget https://asm32.info/fossil/repo/asmbb/doc/trunk/install/asmbb.tar.gz
sudo tar -xvzf asmbb.tar.gz -C /var/www/asmbb --strip-components=1
清理冗余文件：
sudo rm -f asmbb.tar.gz .htaccess lighttpd.conf install.txt License.txt manifest.uuid
注意： 必须保留 Urban Sunrise 和 Wasp 这两个基础主题
cd /var/www/asmbb/templates
sudo rm -rf Light mobile MoLight
NoCSS 是作者新增的模板样式，但尚未内置于当前的预编译包中。如需使用，可按以下步骤手动添加：
# 拉取 tip 分支最新源码
cd /tmp
sudo wget -O asmbb-src.tar.gz https://asm32.info/fossil/asmbb/tarball/tip/asmbb-src.tar.gz
sudo tar -xzf asmbb-src.tar.gz
sudo mv asmbb-src/www/templates/NoCSS /var/www/asmbb/templates/
sudo rm -rf /tmp/asmbb-src* asmbb-src.tar.gz && cd
# 安装 less 编译器
sudo apt update && apt install node-less
# 编译 CSS 样式表
cd /var/www/asmbb/templates/NoCSS
lessc debug.less debug.css
lessc toaster.less toaster.css
lessc users_online.less users_online.css
NoCSS 模板预览如下：
sudo chown -R nginx:nginx /var/www/asmbb
sudo find /var/www/asmbb -type d -exec chmod 750 {} \;
sudo find /var/www/asmbb -type f -exec chmod 640 {} \;
sudo chmod 755 /var/www/asmbb/ld-musl-i386.so
sudo chmod 755 /var/www/asmbb/engine
sudo chmod 640 /var/www/asmbb/libsqlite3.so
sudo vim /etc/systemd/system/asmbb.service
写入以下配置：
[Service]
Type=simple
User=nginx
Group=nginx
WorkingDirectory=/var/www/asmbb
ExecStart=/var/www/asmbb/engine
Restart=on-failure
RestartSec=5
ProtectSystem=full
PrivateDevices=yes
ProtectKernelTunables=yes
ProtectControlGroups=yes
[Install]
WantedBy=multi-user.target
sudo systemctl daemon-reload
sudo systemctl enable --now asmbb
# 检查运行状态
sudo ls -l /var/www/asmbb/engine.sock
sudo systemctl status asmbb
日常维护命令：
# 停止 AsmBB 服务
sudo systemctl stop asmbb
# 启动 AsmBB 服务
sudo systemctl start asmbb
# 重启 AsmBB 服务
sudo systemctl restart asmbb
# 查看日志
sudo journalctl -u asmbb -f
AsmBB 通过 FastCGI 接口与 Web 服务器通信，以下是 Nginx 虚拟主机的配置示例：
# 将 bbs.your.domain 替换为你的实际域名
upstream asmbb {
server unix:/var/www/asmbb/engine.sock;
keepalive 8;
}
server {
listen 80;
listen [::]:80;
server_name bbs.your.domain;
return 301 https://$host$request_uri;
}
server {
listen 443 ssl;
listen [::]:443 ssl;
http2 on;
server_name bbs.your.domain;
root /var/www/asmbb;
# 指定正确的 SSL 证书
ssl_certificate /etc/nginx/cert/bbs.your.domain.pem;
ssl_certificate_key /etc/nginx/cert/bbs.your.domain.key;
ssl_protocols TLSv1.2 TLSv1.3;
ssl_ecdh_curve X25519:P-256:P-384;
ssl_ciphers 'ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-ECDSA-CHACHA20-POLY1305:ECDHE-RSA-AES128-GCM-SHA256:ECDHE-RSA-CHACHA20-POLY1305:ECDHE+AES128:RSA+AES128:ECDHE+AES256:RSA+AES256';
ssl_prefer_server_ciphers off;
ssl_session_timeout 1d;
ssl_session_cache shared:MozSSL:10m;
add_header Strict-Transport-Security "max-age=31536000; includeSubDomains" always;
access_log /var/log/nginx/bbs.your.domain.access.log;
error_log /var/log/nginx/bbs.your.domain.error.log;
add_header X-Frame-Options "SAMEORIGIN" always;
add_header X-XSS-Protection "1; mode=block" always;
add_header X-Content-Type-Options "nosniff" always;
add_header Referrer-Policy "no-referrer-when-downgrade" always;
add_header Content-Security-Policy "default-src http: 'unsafe-eval' 'unsafe-inline'; object-src 'none'; img-src http: data:" always;
location / {
fastcgi_pass asmbb;
fastcgi_read_timeout 3000;
fastcgi_keep_conn on;
include fastcgi_params;
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
fastcgi_param PATH_INFO $fastcgi_path_info;
fastcgi_buffer_size 32k;
fastcgi_buffers 16 16k;
fastcgi_busy_buffers_size 64k;
fastcgi_temp_file_write_size 64k;
}
}
检查并重载 Nginx 配置文件
sudo nginx -t && sudo nginx -s reload
然后，访问 bbs.your.domain，首个注册用户即为管理员。
为减少垃圾注册，同时为用户找回密码提供保障，建议开启电子邮件验证。
AsmBB 原生仅支持无身份验证的 SMTP 连接，并未内置带密码认证的 SMTP 客户端。因此，直接连接常规的外部邮件服务并不现实，通常需要借助本地 Postfix 或其他邮件中继。
不过，AsmBB 支持通过外部程序管道 (Pipe the emails through)，我们可以配置 msmtp 服务来解决发信难题。
sudo apt update
sudo apt install msmtp msmtp-mta ca-certificates
出现以下提示时，选择 No 即可：
创建 msmtp 全局配置文件
写入 SMTP 发信服务器配置：
defaults
auth on
tls on
tls_trust_file /etc/ssl/certs/ca-certificates.crt
# 指定日志路径
logfile /var/log/msmtp.log
# 默认账户
account default
# SMTP 主机名
host smtp.your.mail
# STARTTLS 加密端口通常为 587 (同时设置 tls_starttls on)
# SSL 强制加密端口通常为 465 (同时设置 tls_starttls off)
# 对于端口：
# STARTTLS 通常为 587 (需设置 tls_starttls on)
# SSL 强制加密通常为 465 (需设置 tls_starttls off)
port 465
tls_starttls off
# 发信人邮箱
from [email protected]
# SMTP 用户名
user [email protected]
# SMTP 密码
password veryStrongPassWord!
上面配置文件包含明文密码，需严格控制相关文件与目录的权限：
sudo chown root:nginx /etc/msmtprc
sudo chmod 640 /etc/msmtprc
sudo touch /var/log/msmtp.log
sudo chown nginx:nginx /var/log/msmtp.log
sudo chmod 660 /var/log/msmtp.log
执行以下命令进行测试，将结尾邮件地址替换为自己的收件箱。确认能成功发送邮件后，继续下一步。
echo -e "Subject: Test from msmtp\r\n\r\nThis is a test email sent from the command line." | sudo -u nginx msmtp -t [email protected]
默认 Urban Sunrise 主题下面的邮件模板有点问题，简单修改一下：
# 备份源文件
sudo cp '/var/www/asmbb/templates/Urban Sunrise/activation_email_subject.tpl' '/var/www/asmbb/templates/Urban Sunrise/activation_email_subject.tpl.bak'
sudo cp '/var/www/asmbb/templates/Urban Sunrise/activation_email_text.tpl' '/var/www/asmbb/templates/Urban Sunrise/activation_email_text.tpl.bak'
# 修改邮件主题模板
cat << 'EOF' > "/var/www/asmbb/templates/Urban Sunrise/activation_email_subject.tpl"
[case:[operation]|Account activation for|Email change for|Password reset for] [host]
EOF
# 修改邮件内容模板
cat << 'EOF' > "/var/www/asmbb/templates/Urban Sunrise/activation_email_text.tpl"
Hello [nick], / 你好 [nick],
[case:[operation]
|This email was sent to you because you registered an account on https://[host].
If you didn't, please ignore this email.
To activate your account, please visit the following link:
(这是一封注册验证邮件，请点击下方链接激活您的账号。如非本人操作，请忽略。)
https://[host]/!activate/[secret]/
|This email was sent to confirm your new email address.
If you didn't request this change, please ignore this email.
To activate your new email, please visit the following link:
(这是一封邮箱换绑验证邮件，请点击下方链接完成验证。如非本人操作，请忽略。)
https://[host]/!activate/[secret]/
|This email was sent to confirm your password reset request.
If you didn't request a password reset, please ignore this email.
To reset your password, please copy the code below into the password reset form:
(这是一封密码重置验证邮件。如非本人操作，请忽略。重置验证码如下：)
[secret]
]
Best regards, / 祝好,
The Zsh BBS Team
EOF
在 AsmBB 后台管理设置里，将发信服务器配置为 msmtp 外部程序管道，并开启注册邮件验证功能。
AsmBB 是一款几乎理想的论坛引擎，我喜欢它的小巧、轻量和快速。尽管对中文支持还不太好，但是瑕不掩瑜。
此内容由惯性聚合(RSS阅读器)自动聚合整理，仅供阅读参考。 原文来自 — 版权归原作者所有。