星河留言板（基础版）文档

文档发布日期：2025-03-13 10:13:46

文档更新日期：2025-07-27 19:56:00

1. 产品介绍

星河留言板是一款优雅的轻量级、易用且功能丰富的在线留言板系统，旨在为用户提供一个便捷的互动平台。无论是个人网站、企业官网还是社区论坛，星河留言板都能轻松集成，帮助用户快速搭建留言功能。本安装文档将详细介绍如何安装和配置星河留言板，确保用户能够顺利使用该产品。

2. 核心功能

2.1 留言板系统安装教程

2.1.1 环境要求

在安装星河留言板之前，请确保您的服务器满足以下环境要求：

• 操作系统：Linux（Windows 和 macOS没有测试过，不知道行不行）
• Web 服务器：Apache 或 Nginx
• PHP 版本：PHP 7.0（不适用其它版本）
• 数据库：MySQL 5.6 或更高版本
• PHP扩展：fileinfo和memcache

2.1.1.1 前置条件

这里推荐安装宝塔面板进行操作，宝塔安装教程在百度上有，这里就不介绍了。

另外强调index.php文件要授予755权限（不会的可以百度）

2.1.1.2 安装前必做

当你解压压缩包后会出现如图提示

1.先点击蓝色的“Click here”，下载必备扩展文件

2.将下载好的文件放在如图第二步的位置

3.编辑如图第三步文件内容并保存

4.重启服务器php

2.1.2 安装步骤

1.下载源码

从星河留言板的官方网站或 Gitee 仓库下载最新版本的源码包，并将其解压到您的 Web 服务器目录中。

2.配置 Web 服务器

如果您使用的是 Apache 服务器，确保已启用 .htaccess 文件支持。对于 Nginx 用户，默认即可

3.完成安装

访问 http://你的域名，您将看到星河留言板的主页面，表示安装成功，如果你在完成以上步骤之后看见提示xxx配置缺失，属于正常，按照提示去后台完成填写即可。后台管理员地址/admin

默认密码123456

3. 注意事项

4. 常见问题

1. 如果是校园网可能会导致页面布局异常，没有其他方法，只能换移动数据。
2. 如果在上传文件时出现“504 Gateway Time-out…..”因为线程阻塞导致的，解决方法可以是修改php的配置，可以按照下方去修改，修改之后进行重启（如果是宝塔会很方便，如果是命令行请自行百度操作指令）

max_execution_time = 3600
max_input_time = 3600
memory_limit = 256M
upload_max_filesize = 100M
post_max_size = 105M

如果以上操作还是没有效果，那么等待版本迭代优化，或者再进行调整 Nginx/Tengine 超时配置

在 Nginx 虚拟主机配置中添加或修改：

proxy_connect_timeout 600;
proxy_send_timeout 600;
proxy_read_timeout 600;
send_timeout 600;
client_max_body_size 100M;

重启服务生效：

nginx -s reload

通过以上介绍，相信您已经对星河留言板的核心功能和安装流程有了全面的了解。如果您在安装或使用过程中遇到任何问题，可以在评论区留言。

其它相关内容详见以下：

更新日志：星河留言板版本更新日志 – 田小橙博客

开源地址：https://gitee.com/txc666/xhboard（暂停更新）