英文原文正文为项目原始 README（英文），本站后续会翻译为中文，当前仅剔除图片与无关章节并统一排版。

Bludit

Bludit 简单、快速且灵活的内容管理系统。

使用 Bludit，您可以在几秒钟内建立自己的网站或博客。它完全免费、开源且易于使用。Bludit 将内容以 JSON 格式存储，无需安装或配置数据库。您只需要一个支持 PHP 的网络服务器。

作为一个扁平化文件 CMS，Bludit 提供了无与伦比的灵活性和速度。此外，由于支持 Markdown 和 HTML 代码，创建和管理内容从未如此简单。

资源

• 插件
• 主题
• 文档
• 新闻和公告在 Twitter、Facebook 和 Reddit
• 在 Discord 上聊天与交流
• 在 论坛 上获取帮助和支持
• 在 Github Issues 上报告漏洞

要求

• 支持 PHP 的 Web 服务器。
• PHP 版本 8.0 或更高。
• PHP mbstring 模块，用于全面支持 UTF-8。
• PHP gd 模块，用于图像处理。
• PHP dom 模块，用于 DOM 操作。
• PHP json 模块，用于 JSON 操作。

安装

1. 从官方网站下载最新版本：Bludit.com
2. 将压缩文件解压到一个目录，例如 bludit。
3. 将 bludit 目录上传到您的网络服务器或主机。
4. 访问您的域名（例如，https://example.com/bludit/）。
5. 按照 Bludit 安装程序设置您的网站。

注意——如果在 Cloudflare、nginx、Apache 或其他反向代理后运行： Bludit 仅从 REMOTE_ADDR 读取客户端 IP。在 PHP 层中，像 X-Forwarded-For 或 CF-Connecting-IP 这样的代理头 不被信任，因为任何客户端都可以伪造它们。如果您的网站位于反向代理之后，请配置 Web 服务器在 PHP 接收请求之前将 REMOTE_ADDR 重写为真实客户端 IP——否则登录暴力破解黑名单将阻止代理本身（在足够的失败登录尝试后锁定所有访问者），并且访问者统计将把所有流量计算为单一访问者。

• Apache — 启用 mod_remoteip 模块，并使用 RemoteIPTrustedProxy 列出上游的 IP 范围。对于 Cloudflare，使用头 CF-Connecting-IP 并使用 cloudflare.com/ips-v4 和 cloudflare.com/ips-v6 上发布的 IP 范围。
• nginx — 使用内置的 ngx_http_realip_module 模块，配合 set_real_ip_from 和 real_ip_header。

直接 / 本地主机 / 内网部署无需任何配置。

快速安装测试

你可以使用 PHP 内置的网页服务器（php -S localhost:8000）或 Docker：

docker pull bludit/docker:latest
docker run -d --name bludit -p 8000:80 bludit/docker:latest

然后打开 http://localhost:8000

升级 Bludit

以下步骤适用于从相同主版本升级到任何版本的 Bludit。主版本是版本号中的第一个数字，例如 Bludit v3.x。

1. 完全备份，这里无需讨论，对所有文件和目录进行完整备份。这意味着将所有文件复制到一个新文件夹中。
2. 记住你正在使用的 Bludit 版本，以便可能回滚。
3. 从官方网站下载最新版。
4. 解压 zip 文件。
5. 用新文件替换现有文件。
6. 清理浏览器缓存，请阅读下面的注意事项。
7. 登录管理区域并检查你的设置。
8. 完成。

注意： 如果你的网站处于某种服务器缓存系统（例如，Cloudflare 默认提供的缓存）后面，你也需要在那里清除文件。清理浏览器缓存也是一个好主意。Bludit 会尝试用新文件重新加载，但某些组件如 TinyMCE 可能不会重新加载，从而在界面上产生一些问题或抛出 JavaScript 错误。

支持 Bludit

Bludit 是开源且免费使用的，但如果你觉得这个项目有用并希望支持其开发，你可以在 Patreon 进行贡献。作为我们的感谢，支持者将获得 Bludit PRO。

如果你愿意，你也可以通过一次性捐款来请我们喝咖啡或啤酒。每一份贡献都帮助我们继续改进 Bludit，为用户提供最佳体验。

• PayPal
• BTC（比特币）：bc1qtets5pdj73uyysjpegfh2gar4pfywra4rglcph
• ETH（以太坊）：0x0d7D58D848aA5f175D75Ce4bC746bAC107f331b7

许可证

Bludit 是开源软件，采用 MIT 许可证 授权。