使用文档

从环境准备到上线运营,完整部署与配置指南。

环境要求

  • PHP 8.0 或更高版本
  • MySQL 5.7+ 或 MariaDB 10.3+
  • Apache / Nginx(建议开启 URL 重写)
  • PDO、GD、Fileinfo 扩展
  • Composer(可选,用于依赖管理)

安装步骤

  1. 购买授权后联系客服获取源码包。
  2. 将源码上传至服务器 Web 目录。
  3. 修改 .envconfig/database.php 配置数据库连接。
  4. 执行 database/install.sql 初始化数据库。
  5. 设置 runtime 目录可写权限。
  6. 访问后台:https://yourdomain.com/admin,默认账号 admin / admin123
# 部署示例
1. 联系客服获取授权与源码包
2. 上传源码到服务器 Web 目录
3. 配置数据库并导入 install.sql
4. 完成后台初始化与基础设置

基础配置

登录后台后进入“基础设置”,可配置:

  • 站点标题、副标题、页脚信息、ICP 备案号
  • 每页显示条数
  • 是否开启前台申请收录
  • 是否自动通过申请
  • 是否开启死链检测
  • 是否开启会员-only 模式
  • 后台登录路径(默认 admin)

分类管理

后台“分类管理”支持无限级树形分类。建议先规划好一级分类(如“常用工具”“游戏资源”“技术博客”),再逐级添加子分类。分类排序值越小越靠前。

首页左侧目录会按分类层级以文件夹形式渲染,点击分类名称即可展开该分类下的链接。

进入“链接管理”,可以新增、编辑、删除链接。关键字段说明:

  • 状态:待审核、已通过、已拒绝,只有通过审核的链接才会在前台显示。
  • 置顶:置顶链接会在分类内最前面展示。
  • 排序:数字越小越靠前,可后台列表直接修改。
  • iframe 内嵌:开启后点击链接以 iframe 方式在当前页打开。
  • 加密:设置访问密码,前台点击需输入密码。

会员权限

后台“会员管理”可创建会员并设置多维限制:

  • 访问时间段:设置允许访问的起止时间,留空不限制。
  • 每日最大访问次数:0 表示无限制。
  • 最大同时在线设备数:基于 UA 指纹统计。
  • 最多登录设备数(累计):控制历史累计设备上限。

开启“会员-only 模式”后,未登录会员将无法查看任何链接。

后台“链接管理”页面提供“检测死链”按钮,点击后系统会依次访问所有链接并标记无法访问的 URL。检测结果会在列表中显示“死链”状态,前台自动隐藏死链。

注意:死链检测为同步执行,链接数量较多时可能需要等待,建议在访问量低峰期操作。

安全建议

  • 首次部署后务必修改默认管理员密码。
  • 修改后台路径(admin_path)并妥善保管。
  • .env 或数据库配置中敏感信息设置为不可读。
  • 定期备份数据库与上传目录。
  • 建议开启 HTTPS。

常见问题

数据库连接失败怎么办?

检查 .env 或 config/database.php 中的 host、port、database、username、password 是否正确;确认 MySQL 已启动且账号有对应数据库权限。

前台 404 怎么办?

确认 Web 服务器已开启 URL 重写:Apache 需要启用 mod_rewrite,Nginx 需要配置 try_files 指向 index.php。

如何升级已部署站点?

备份数据库和文件后,按 database/migrations 目录下的迁移脚本顺序执行 ALTER 语句,再覆盖升级文件。