TypeRenew - 焕新 CMS 程序

TypeRenew 是基于开源博客系统 Typecho 所开发的现代化 CMS 程序，完整继承其轻量、简洁、高效的内核基因，同时针对现代运行环境进行优化，修复兼容问题并原生集成缓存、邮件、在线升级等实用功能，同时提供安全中心、SEO、优化加速、外链安全与编辑器增强等官方拓展能力，适合搭建个人博客或轻量内容站点，QQ 交流群：1073739854

开发背景

Typecho 作为知名的轻量级博客程序，以代码简洁、运行高效著称，但原版项目维护节奏较慢，存在以下问题：

• 对 PHP 8.0+ 环境的兼容性不足
• 缺少现代化的界面设计，操作体验相对陈旧
• 未内置缓存机制，高并发场景下性能受限
• 相较于其他 CMS，较多 “基础功能” 需要额外依赖第三方插件实现
• 历经多年，三方插件开发、适配混乱，难以 “开箱即用”

因此，TypeRenew 的开发初衷是解决上述问题，并在继承 Typecho 开发精神的前提下，提供开箱即用的现代化体验。

同时，项目的实现基于对 Typecho 原有代码的渐进式改造，这让原 Typecho 用户可以平滑迁移至 TypeRenew，开发者也能快速上手进行二次开发。

核心能力

现代化运行环境支持

• 最低要求 PHP 8.0，充分利用现代 PHP 特性
• 支持 MySQL 5.7.7+ / MariaDB 10.3+、PostgreSQL 10+、SQLite 3.x 等数据库
• MySQL / MariaDB 安装流程默认使用 utf8mb4 + InnoDB，并根据版本自动选择合适的排序规则
• 内置缓存层，原生集成 Redis 或 APCu 缓存，显著降低数据库查询压力
• 内置邮件队列、密码重置、数据库结构升级与在线升级入口，减少依赖额外插件的基础能力补齐成本

内置插件

为 TypeRenew 提供官方专用拓展集合，请前往官方插件仓库：https://github.com/Yangsh888/TypeRenew-plugins

当前已开发 RenewBoost、RenewShield、RenewSEO、RenewGo、VditorRenew、RenewLocation 六个官方插件，可按需启用，分别覆盖优化加速、安全防护、SEO、外链安全、后台编辑器增强、CZDB 纯真数据库解析等能力。

社区拓展

TypeRenew Add-ons是由社区开发者 @abdulhalim 贡献的第三方拓展，为 TypeRenew 补充多语言本地化与界面适配能力，适配 TypeRenew v1.5.1 及以上版本，提供完整的英文（en_US）、波斯语（fa_IR）语言包与全自动从右到左（RTL）布局支持，覆盖前台默认主题、后台管理面板与安装引导页全场景。

项目仓库：https://github.com/abdulhalim/TypeRenew-Add-ons

核心特性：

• 提供核心系统与默认主题双层语言包，完整覆盖前后台界面文本
• 基于当前激活语言自动切换 RTL / LTR 布局，原生适配波斯语等右向书写语言
• 内嵌 Vazirmatn 字体，优化波斯语排版与阅读体验
• 轻量无插件实现，仅需少量核心代码补丁，无额外性能开销
• 兼容 TypeRenew 原生深色模式与响应式布局

运行环境

系统要求

项目	最低要求	推荐配置
PHP	8.0	8.2+
MySQL	5.7.7	8.0+
MariaDB	10.3	10.6+
PostgreSQL	10	12+
SQLite	3.x	3.x
Redis（可选）	5.0	6.0+

PHP 扩展要求

必需扩展：

• mbstring
• json
• Reflection

数据库扩展（至少安装一个）：

• mysqli 或 pdo_mysql（MySQL）
• pgsql 或 pdo_pgsql（PostgreSQL）
• sqlite3 或 pdo_sqlite（SQLite）

可选扩展：

• redis（缓存加速）
• apcu（缓存加速）

目录权限

安装前请确保以下目录具有写入权限：

• /usr/uploads/ - 上传文件存储目录
• / - 根目录（安装时需要写入 config.inc.php）

安装部署

获取代码

从 Release 中下载压缩包，解压到 Web 服务器根目录。

执行安装程序

1. 在浏览器中访问 http://your-domain.com/
2. 第一步：系统自动检测环境，确认 PHP 版本和扩展满足要求，阅读并同意许可协议
3. 第二步：填写数据库连接信息，选择数据库类型（MySQL/PostgreSQL/SQLite），设置表前缀；若使用 MySQL / MariaDB，安装器会固定使用 utf8mb4 与 InnoDB
4. 第三步：创建管理员账号，设置用户名、邮箱和密码
5. 安装完成后自动跳转到后台登录页面

安装程序会在根目录生成 config.inc.php 配置文件，包含数据库连接信息和系统初始化代码。

从原版 Typecho 迁移

1. 通过 Typecho 后台 “备份” 页，对原站点数据进行备份，系统会自动下载 .dat 格式备份文件
2. 手动备份原站点的 usr/ 目录
3. 从 Release 中下载压缩包，解压到 Web 服务器根目录
4. 将备份的原站点 usr/ 目录复制到新站
5. 执行 TypeRenew 全新安装程序
6. 登录管理后台，在 “备份” 页上传 .dat 格式备份文件，并按页面指引完成恢复流程
7. 重新启用插件和主题

增强功能

启用缓存

1. 后台「设置」-「缓存」
2. 开启缓存状态
3. 选择驱动类型（Redis 或 APCu）
4. 设置缓存前缀和默认过期时间
5. 保存配置

启用后，系统会自动缓存数据库查询结果和页面片段，并在数据变更时自动更新缓存。

配置邮件

1. 后台「设置」-「邮件」
2. 选择发送方式（SMTP 或 PHP mail）
3. 填写 SMTP 服务器地址、端口、账号密码
4. 设置发件人名称和地址
5. 点击「发送测试邮件」验证配置

配置完成后，评论通知、密码重置等邮件将自动发送。

邮件设置页同时提供队列概览、立即投递、清理已发送、重试失败与测试发信等能力，便于在生产环境中排查和维护发信状态。

数据备份与恢复

1. 后台「管理」-「备份」
2. 可导出核心内容数据为 .dat 备份文件
3. 支持上传备份文件或从服务器已有备份进行恢复
4. 恢复完成后，页面会给出阻断项、预警项与处理摘要，便于核对恢复结果

升级程序

1. 后台「管理」-「升级」
2. 支持数据库结构升级、关键结构诊断与 MySQL / MariaDB 升级风险检查
3. 若已放置升级包，可在该页面执行在线升级流程

常见问题

安装时提示「上传目录暂无写入权限」

确保 /usr/uploads/ 目录存在且具有写入权限：

mkdir -p usr/uploads
chmod 755 usr/uploads

安装后访问首页显示空白页

1. 检查 config.inc.php 是否正确生成
2. 检查数据库连接信息是否正确
3. 查看 PHP 错误日志定位具体原因

缓存启用后页面不更新

缓存会在数据变更时自动失效，如果手动修改了数据库，可通过后台「设置」-「缓存」点击「清空缓存」强制刷新。

邮件发送失败

1. 检查 SMTP 服务器地址和端口是否正确
2. 确认 SMTP 服务器支持该端口（部分服务商封锁 25 端口）
3. 尝试更换加密方式（SSL/TLS）
4. 查看后台「设置」-「邮件」页面的错误日志

后台无法登录

1. 清除浏览器 Cookie 后重试
2. 检查 config.inc.php 中的站点 URL 配置
3. 确认数据库中 typerenew_users 表存在且管理员账号正常

开源许可协议

本项目基于 GNU General Public License 2.0 协议开源。

核心条款：

• 可以自由使用、修改、分发本软件
• 分发时必须保留原始版权声明和许可证
• 修改后的版本必须以相同协议开源
• 不提供任何担保，作者不承担使用本软件产生的任何责任

完整协议文本见 LICENSE 文件或访问 GNU GPL 2.0。

商标与授权说明

TypeRenew 名称、Logo 商标 均为 东莞市次元幻域网络科技有限公司 所有，本项目已获合法授权使用，请勿将该商标用于修改后衍生版本的对外分发、自有产品推广或商标抢注，避免误导用户；如需商业场景的商标授权，可联系 support@nekoteco.com 咨询。

本项目的开源许可证仅覆盖代码授权，不包含商标权利。但对于所有遵守本项目开源协议（GPL-2.0）的用户，我们豁免其在合规开源分发场景下的商标使用限制，您可在自行部署自用、分发未修改的官方原版时，正常使用该商标，无需额外申请授权。

同时，本项目为基于 Typecho 的衍生改进版本，我们完全尊重上游项目的版权与商标权益。在此重申，本项目并非 Typecho 官方版本，原项目所有权利均归 Typecho 开发团队所有。

致谢

TypeRenew 的开发建立在以下开源项目的基础上：

• Typecho - 本项目的初始来源
• Vditor - 广受好评的 Markdown 编辑器

感谢 Typecho 开发团队和其他所有贡献者所创造的优秀产品，同时还要感谢开源社区的支持。