XiunoBBS建站教程：轻量高性能论坛安装指南

XiunoBBS（修罗论坛）是一款国产开源轻量级论坛系统，基于PHP开发，以MIT协议开源，完全免费商用。XiunoBBS诞生于2010年，以极致轻量、高性能、低资源占用著称，单文件核心仅几百KB，支持百万级帖子，是国内最轻量的论坛程序。XiunoBBS内置帖子管理、用户管理、积分体系、附件上传、插件机制、模板体系，适合搭建小型社区、技术论坛、产品支持社区、兴趣讨论区。

核心优势：极致轻量（核心代码少、加载快）、性能卓越（支持百万级数据）、低资源占用（虚拟主机即可运行）、安装简单、界面简洁、插件扩展、SEO友好、完全免费商用、国内开发者维护。XiunoBBS是追求轻量和性能的论坛用户首选，特别适合低配置服务器和虚拟主机。

环境要求

• Web服务器：Nginx / Apache / IIS
• PHP版本：PHP 5.4 ~ 8.2（XiunoBBS 4.x推荐PHP 7.4/8.0）
• 数据库：MySQL 5.0+ / MariaDB
• 内存：最低64MB，推荐128MB以上（极低资源占用）
• 磁盘：至少50MB可用空间
• PHP扩展：mysql、mysqli、pdo_mysql、gd、mbstring、json、curl
• 可选：Redis（用于缓存加速）

安装教程

步骤1：下载XiunoBBS安装包

cd /www/wwwroot/yourdomain.com
wget https://www.xiuno.com/down/xiunobbs_4.0.4.zip
unzip xiunobbs_4.0.4.zip
rm -f xiunobbs_4.0.4.zip

解压后将upload目录内的所有文件移至网站根目录。注意：请从官网获取最新版本号。

步骤2：创建数据库

mysql -u root -p
CREATE DATABASE xiuno DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
CREATE USER 'xiuno_user'@'localhost' IDENTIFIED BY 'your_strong_password';
GRANT ALL PRIVILEGES ON xiuno.* TO 'xiuno_user'@'localhost';
FLUSH PRIVILEGES;
EXIT;

步骤3：配置文件权限

chown -R www:www /www/wwwroot/yourdomain.com
chmod -R 755 /www/wwwroot/yourdomain.com
chmod -R 777 /www/wwwroot/yourdomain.com/upload
chmod -R 777 /www/wwwroot/yourdomain.com/tmp
chmod 666 /www/wwwroot/yourdomain.com/conf/conf.php 2>/dev/null || true

步骤4：Nginx配置

server {
    listen 80;
    server_name yourdomain.com www.yourdomain.com;
    root /www/wwwroot/yourdomain.com;
    index index.php index.html;

    location / {
        if (!-e $request_filename) {
            rewrite ^(.*)$ /index.php?$1 last;
        }
    }

    location ~ \.php$ {
        fastcgi_pass unix:/tmp/php-cgi-80.sock;
        fastcgi_index index.php;
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
        include fastcgi_params;
    }

    location ~* \.(js|css|png|jpg|jpeg|gif|ico|svg|woff|woff2|ttf|eot)$ {
        expires 30d;
        add_header Cache-Control "public, immutable";
    }

    location ~ /\.ht {
        deny all;
    }

    location ~ /(conf|tmp)/ {
        deny all;
    }
}

步骤5：运行安装向导

浏览器访问 http://yourdomain.com/install/，进入安装页面：

1. 阅读安装协议，点击”同意”

\li>环境检测页面，确认所有检测项通过（PHP版本、MySQL扩展、目录权限等）

2. 填写数据库配置：
   • 数据库类型：MySQL（PDO）
   • 数据库服务器：localhost
   • 数据库端口：3306
   • 数据库名：xiuno
   • 数据库用户名：xiuno_user
   • 数据库密码：你的密码
   • 表前缀：bbs_（默认即可）
3. 填写管理员信息：
   • 管理员用户名：admin
   • 管理员密码：设置强密码
   • 管理员邮箱：你的邮箱
4. 填写网站信息：
   • 网站名称：你的论坛名称
   • 网站描述：简短描述
5. 点击”安装”，等待安装完成（XiunoBBS安装非常快）

步骤6：删除安装目录并登录后台

rm -rf /www/wwwroot/yourdomain.com/install

访问 http://yourdomain.com/admin/ 登录后台。XiunoBBS后台功能包括：论坛管理、版块管理、帖子管理、用户管理、用户组权限、插件管理、模板管理、数据备份、系统设置、SEO设置等。

Windows环境安装（phpStudy集成环境）

对于Windows用户，推荐使用phpStudy或XAMPP集成环境快速搭建：

1. 下载安装phpStudy（https://www.xp.cn）或XAMPP（https://www.apachefriends.org）
2. 启动集成环境，开启Apache/Nginx和MySQL服务
3. 将程序源码解压到网站根目录（phpStudy默认是WWW目录，XAMPP默认是htdocs目录）
4. 打开phpMyAdmin创建数据库（访问http://localhost/phpmyadmin）
5. 浏览器访问http://localhost，按照安装向导完成安装

注意：Windows环境仅推荐用于本地开发和测试，生产环境建议使用Linux服务器。

宝塔面板安装（推荐）

宝塔面板是国内最流行的服务器管理面板，支持一键部署PHP环境和网站：

1. 安装宝塔面板：CentOS执行yum install -y wget && wget -O install.sh https://download.bt.cn/install/install_6.0.sh && sh install.sh，Ubuntu/Debian执行wget -O install.sh https://download.bt.cn/install/install-ubuntu_6.0.sh && sudo bash install.sh
2. 安装完成后，登录宝塔面板（地址和账号密码在安装完成后显示）
3. 首次登录提示安装LNMP/LAMP环境，选择Nginx + MySQL + PHP，点击一键安装
4. 点击”网站” → “添加站点”，填写域名、选择PHP版本、创建数据库
5. 将程序源码上传到网站根目录（/www/wwwroot/你的域名）
6. 设置目录权限：在文件管理器中选中网站目录，权限设置为755，所有者为www
7. 浏览器访问域名，按照安装向导完成安装

宝塔面板优势：可视化操作、一键环境配置、方便管理数据库和文件、内置SSL证书部署、适合新手和非技术用户。

服务器配置建议

• PHP内存限制：memory_limit = 64M（XiunoBBS极低占用，128M足够）
• 上传文件大小：upload_max_filesize = 16M，post_max_size = 16M
• 最大执行时间：max_execution_time = 60
• 启用OPcache加速（效果明显）
• 配置Redis缓存（XiunoBBS内置支持，大幅提升性能）
• 后台 → 系统设置 → 开启URL重写（需Nginx配置支持）
• 开启GZIP压缩
• MySQL配置优化：增加innodb_buffer_pool_size
• 定期备份数据库和upload目录
• 关注XiunoBBS官方更新，及时升级

常用插件推荐

• xiuno_top：置顶帖插件
• xiuno_attach：附件下载积分插件
• xiuno_smtp：SMTP邮件插件
• xiuno_seo：SEO增强插件
• xiuno_qqlogin：QQ登录插件
• xiuno_smilies：表情插件
• xiuno_markdown：Markdown编辑器插件
• xiuno_uv：UV统计插件

常见问题

Q：安装时提示”tmp目录不可写”？
A：执行chmod -R 777 tmp upload，确保目录所有者为www用户。

Q：后台登录提示验证码错误？
A：检查PHP是否安装了gd扩展，验证码依赖gd库。执行apt install php8.0-gd。

Q：开启URL重写后页面404？
A：确认Nginx配置中包含rewrite规则：if (!-e $request_filename) { rewrite ^(.*)$ /index.php?$1 last; }，并在后台系统设置中开启URL重写。

Q：忘记管理员密码怎么办？
A：数据库执行：UPDATE bbs_user SET password=MD5(CONCAT(MD5('新密码'), salt)) WHERE uid=1;。或直接在数据库中修改password字段为已知密码的哈希值。

Q：XiunoBBS和Discuz怎么选？
A：追求轻量、快速、低资源占用选XiunoBBS；需要功能全面、插件丰富、大型社区选Discuz。小型论坛和技术社区推荐XiunoBBS，大型综合社区推荐Discuz。

Q：XiunoBBS可以商用吗？
A：可以。XiunoBBS基于MIT协议开源，完全免费商用，无需授权，也无需保留版权信息。

官方网址

官方网站：https://www.xiuno.com

下载地址：https://www.xiuno.com/down.htm

官方文档：https://www.xiuno.com/wiki/

插件市场：https://www.xiuno.com/plugin/

GitHub：https://github.com/xiuno/xiunobbs

社区论坛：https://www.xiuno.com/bbs/