部署文档 - 星核引导页

环境要求

确保你的服务器满足以下基本要求

PHP 7.4+

推荐使用 PHP 8.0 及以上版本以获得最佳性能和兼容性

JSON 扩展

用于读取和写入 JSON 配置文件，通常默认已启用

Fileinfo 扩展

用于文件类型检测，确保上传功能正常工作

安装步骤

按照以下步骤完成安装部署

1

下载源码

从 GitHub 仓库下载最新版本的源码，或使用 git clone 命令克隆仓库到本地。也可以在下载页面直接下载压缩包。

2

上传到服务器

将下载的源码文件上传到你的 Web 服务器根目录（如 /var/www/html/），可以通过 FTP、SFTP 或服务器面板上传。

3

配置目录权限

设置网站目录的读写权限，确保 PHP 能够正常读写 JSON 数据文件。通常设置为 755 或 777（根据服务器配置）。

4

访问首页完成安装

在浏览器中访问你的域名，系统会自动检测并引导你完成初始化配置，包括设置管理员账号、站点信息等。

目录结构

了解项目的文件组织方式

starcore/ ├── admin/ # 后台管理目录 │ ├── index.php # 后台入口 │ └── ... ├── api/ # API 接口目录 │ ├── config.php # 配置接口 │ ├── message.php # 留言接口 │ └── ... ├── assets/ # 静态资源目录 │ ├── css/ # 样式文件 │ ├── js/ # 脚本文件 │ └── img/ # 图片资源 ├── data/ # 数据存储目录 │ ├── site.json # 站点配置 │ ├── links.json # 友链数据 │ ├── messages.json # 留言数据 │ └── users.json # 用户数据 ├── index.php # 首页入口 ├── apply.php # 申请页面 └── README.md # 项目说明

配置说明

site.json 配置文件字段说明

字段名	类型	说明	示例值
`site_name`	String	站点名称	"我的主页"
`site_description`	String	站点描述	"欢迎来到我的个人主页"
`site_url`	String	站点 URL	"https://example.com"
`theme`	String	默认主题模式	"dark" / "light"
`background_image`	String	背景图片 URL	"https://..."
`favicon`	String	Favicon 图标 URL	"assets/img/favicon.ico"
`nickname`	String	昵称	"星核"
`avatar`	String	头像 URL	"https://..."
`signature`	String	个性签名	"探索无限可能"
`social_links`	Object	社交链接配置	{"github": "...", "qq": "..."}
`security`	Object	安全防护配置	{"disable_right_click": true}

常见问题

部署过程中遇到问题？看看这里有没有答案

星核引导页支持 PHP 7.4 及以上版本。推荐使用 PHP 8.0 或 8.1 以获得最佳性能和安全性。不支持 PHP 7.3 及以下版本。

不需要。星核引导页使用 JSON 文件存储数据，无需配置 MySQL 等数据库，大大简化了部署流程。只需确保 PHP 有读写 data 目录的权限即可。

你可以通过后台管理面板直接修改主题设置，也可以手动编辑 data/site.json 配置文件。支持深色/浅色模式切换、自定义背景图、自定义配色方案等。

支持。星核引导页兼容 Apache 和 Nginx 等 Web 服务器。在 Nginx 下需要确保已正确配置 PHP 解析，并设置适当的伪静态规则（如果需要）。

如果使用 git 部署，只需执行 git pull 拉取最新代码即可。如果是手动上传，请下载最新版本覆盖旧文件。注意更新前请备份 data 目录下的数据文件。

500 错误通常是服务器权限问题。请检查：1) data 目录是否有写入权限；2) PHP 版本是否符合要求；3) 是否缺少必要的 PHP 扩展。可以查看服务器错误日志获取详细信息。