安装步骤

Yuan-ICP 提供了简单易用的Web安装向导，只需几个步骤即可完成系统部署。

🚀 快速安装

1. 下载和准备

下载源码

bash

# 使用 Git 克隆项目
git clone https://github.com/bbb-lsy07/Yuan-ICP.git
cd Yuan-ICP

# 或者下载 ZIP 包后解压
wget https://github.com/bbb-lsy07/Yuan-ICP/archive/main.zip
unzip main.zip
cd Yuan-ICP-main

安装依赖

bash

# 安装 PHP 依赖（主要是 PHPMailer）
composer install

# 如果没有 Composer，可以手动下载依赖
# 系统会自动检测并提示

设置目录权限

bash

# 设置必要目录的写入权限
chmod 755 config/
chmod 755 data/
chmod 755 uploads/
chmod 755 themes/

# 如果使用 Apache，确保 .htaccess 文件可读
chmod 644 .htaccess

2. Web服务器配置

Apache 配置

apache

<VirtualHost *:80>
    ServerName your-domain.com
    DocumentRoot /path/to/yuan-icp
    
    <Directory /path/to/yuan-icp>
        AllowOverride All
        Require all granted
    </Directory>
    
    # 可选：启用压缩
    <IfModule mod_deflate.c>
        AddOutputFilterByType DEFLATE text/html text/plain text/xml text/css text/javascript application/javascript
    </IfModule>
</VirtualHost>

Nginx 配置

nginx

server {
    listen 80;
    server_name your-domain.com;
    root /path/to/yuan-icp;
    index index.php;
    
    location / {
        try_files $uri $uri/ /index.php?$query_string;
    }
    
    location ~ \.php$ {
        fastcgi_pass 127.0.0.1:9000;
        fastcgi_index index.php;
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
        include fastcgi_params;
    }
    
    # 安全设置
    location ~ /\. {
        deny all;
    }
    
    location ~* \.(log|sql|txt)$ {
        deny all;
    }
}

🔧 安装向导

第一步：环境检查

访问您的网站首页，系统会自动跳转至 /install/step1.php。

检查项目

安装向导会检查以下环境要求：

PHP 版本检查

✅ PHP >= 7.4
✅ PHP 扩展：PDO、GD、cURL、mbstring、OpenSSL

目录权限检查

功能检查

✅ URL重写支持
✅ 文件上传功能
✅ 会话支持

解决常见问题

PHP扩展缺失

bash

# Ubuntu/Debian
sudo apt-get install php-pdo php-gd php-curl php-mbstring php-openssl

# CentOS/RHEL
sudo yum install php-pdo php-gd php-curl php-mbstring php-openssl

目录权限问题

bash

# 设置正确的目录权限
sudo chown -R www-data:www-data /path/to/yuan-icp
sudo chmod -R 755 /path/to/yuan-icp
sudo chmod -R 777 config/ data/ uploads/ themes/

第二步：系统配置

在 /install/step2.php 页面配置系统基本信息。

站点信息配置

配置项	说明	示例
网站名称	显示在页面标题和邮件中	"Yuan-ICP 备案系统"
网站URL	完整的网站地址	"https://icp.example.com"
时区设置	系统时区	"Asia/Shanghai"

数据库配置

推荐：SQLite（零配置）

选择 SQLite 数据库
数据库文件将自动创建在 data/sqlite.db
无需额外配置，开箱即用

高级：MySQL/PostgreSQL

php

// MySQL 配置示例
'driver' => 'mysql',
'host' => 'localhost',
'port' => '3306',
'database' => 'yuan_icp',
'username' => 'your_username',
'password' => 'your_password',
'charset' => 'utf8mb4'

管理员账户设置

字段	要求	说明
用户名	3-20字符，字母数字下划线	后台登录用户名
密码	至少8位，包含字母数字	建议使用强密码
邮箱	有效邮箱格式	用于接收系统通知

备份恢复（可选）

如果您有现有的备份文件：

上传 sqlite.db 备份文件
系统将跳过数据库初始化
直接使用备份数据

第三步：完成安装

点击"开始安装"后，系统将执行以下操作：

自动执行的任务

创建配置文件
- 生成 config/database.php
- 设置数据库连接参数
初始化数据库
- 执行 install/database.sql
- 创建所有必要数据表
- 插入基础配置数据
创建管理员账户
- 创建超级管理员用户
- 密码自动加密存储
设置系统配置
- 保存站点基本信息
- 初始化系统参数

安装完成提示

安装成功后，系统会显示：

✅ 数据库初始化完成
✅ 管理员账户创建成功
✅ 系统配置保存完成
⚠️ 请删除 install 目录

🔒 安装后安全设置

1. 删除安装目录

重要：为了安全，请务必在安装完成后删除或重命名 install 文件夹！

bash

# 删除安装目录
rm -rf install/

# 或者重命名（推荐，便于将来重装）
mv install/ install_backup/

2. 首次登录

访问后台

前台地址：https://your-domain.com/
后台地址：https://your-domain.com/admin/

登录步骤

访问后台登录页面
输入安装时设置的管理员账户
登录成功后进入仪表盘

3. 基本配置检查

登录后台后，建议检查以下配置：

系统设置

确认站点名称和URL正确
设置合适的时区
配置SEO相关信息

邮件配置

配置SMTP服务器信息
测试邮件发送功能
设置发件人信息

号码池设置

选择号码生成模式（自动生成/号码池）
配置号码生成规则
添加预设号码（如使用号码池模式）

📊 验证安装

功能测试清单

前台功能测试

[ ] 访问首页，查看是否正常显示
[ ] 测试备案申请流程
[ ] 验证号码选择功能
[ ] 测试备案查询功能
[ ] 查看公告列表

后台功能测试

[ ] 管理员登录
[ ] 查看仪表盘数据
[ ] 审核备案申请
[ ] 发布系统公告
[ ] 修改系统设置

邮件功能测试

[ ] 配置SMTP设置
[ ] 发送测试邮件
[ ] 验证审核通知邮件

性能优化建议

PHP配置优化

ini

# php.ini 推荐设置
memory_limit = 256M
max_execution_time = 60
upload_max_filesize = 10M
post_max_size = 10M
date.timezone = Asia/Shanghai

数据库优化

sql

-- 为常用查询添加索引
CREATE INDEX idx_applications_status ON icp_applications(status);
CREATE INDEX idx_applications_created ON icp_applications(created_at DESC);
CREATE INDEX idx_config_key ON system_config(config_key);

🚨 故障排除

常见安装问题

1. 环境检查失败

问题：PHP扩展缺失或版本不符 解决方案：

bash

# 检查PHP版本
php -v

# 检查已安装扩展
php -m | grep -E "(pdo|gd|curl|mbstring|openssl)"

# 安装缺失扩展
sudo apt-get install php-[extension-name]

2. 目录权限错误

问题：无法写入配置或数据目录 解决方案：

bash

# 检查目录权限
ls -la config/ data/ uploads/ themes/

# 设置正确权限
sudo chmod -R 755 /path/to/yuan-icp/
sudo chmod -R 777 config/ data/ uploads/ themes/

3. 数据库连接失败

问题：无法连接到数据库 解决方案：

检查数据库服务是否运行
验证连接参数是否正确
确认数据库用户权限

4. URL重写问题

问题：页面显示404错误 解决方案：

apache

# Apache: 确保启用mod_rewrite
sudo a2enmod rewrite
sudo systemctl restart apache2

# 检查.htaccess文件是否存在
ls -la .htaccess

5. 会话问题

问题：无法保持登录状态 解决方案：

php

// 检查session配置
php -i | grep session

// 确保session目录可写
ls -la /tmp/

重新安装

如果安装过程中出现问题，可以重新安装：

清理现有数据

bash

rm -f config/database.php
rm -f data/sqlite.db

恢复安装目录

bash

# 如果之前重命名了install目录
mv install_backup/ install/

重新访问网站
- 系统会重新跳转到安装向导
- 按照正常流程重新安装

📋 安装后检查清单

完成安装后，请按以下清单检查：

安全检查

[ ] 已删除或重命名install目录
[ ] 管理员密码足够强壮
[ ] 敏感目录访问权限正确设置

功能检查

[ ] 前台页面正常访问
[ ] 后台管理功能正常
[ ] 邮件发送功能正常
[ ] 数据库读写正常

配置检查

[ ] 站点信息配置正确
[ ] 时区设置正确
[ ] 邮件配置完成
[ ] 号码生成规则设置

📚 相关文档

环境要求 - 详细的系统要求说明
升级指南 - 系统升级操作指南
系统设置 - 安装后的系统配置
故障排除 - 常见问题解决方案

🆘 获取帮助

如果在安装过程中遇到问题：

查看 GitHub Issues
在 Discussions 中寻求帮助
查看系统错误日志文件
联系技术支持团队

安装步骤 ​

🚀 快速安装 ​

1. 下载和准备 ​

下载源码 ​

安装依赖 ​

设置目录权限 ​

2. Web服务器配置 ​

Apache 配置 ​

Nginx 配置 ​

🔧 安装向导 ​

第一步：环境检查 ​

检查项目 ​

解决常见问题 ​

第二步：系统配置 ​

站点信息配置 ​

数据库配置 ​

管理员账户设置 ​

备份恢复（可选） ​

第三步：完成安装 ​

自动执行的任务 ​

安装完成提示 ​

🔒 安装后安全设置 ​

1. 删除安装目录 ​

2. 首次登录 ​

访问后台 ​

登录步骤 ​

3. 基本配置检查 ​

系统设置 ​

邮件配置 ​

号码池设置 ​

📊 验证安装 ​

功能测试清单 ​

前台功能测试 ​

后台功能测试 ​

邮件功能测试 ​

性能优化建议 ​

PHP配置优化 ​

数据库优化 ​

🚨 故障排除 ​

常见安装问题 ​

1. 环境检查失败 ​

2. 目录权限错误 ​

3. 数据库连接失败 ​

4. URL重写问题 ​

5. 会话问题 ​

重新安装 ​

📋 安装后检查清单 ​

安全检查 ​

功能检查 ​

配置检查 ​

📚 相关文档 ​

🆘 获取帮助 ​

安装步骤

🚀 快速安装

1. 下载和准备

下载源码

安装依赖

设置目录权限

2. Web服务器配置

Apache 配置

Nginx 配置

🔧 安装向导

第一步：环境检查

检查项目

解决常见问题

第二步：系统配置

站点信息配置

数据库配置

管理员账户设置

备份恢复（可选）

第三步：完成安装

自动执行的任务

安装完成提示

🔒 安装后安全设置

1. 删除安装目录

2. 首次登录

访问后台

登录步骤

3. 基本配置检查

系统设置

邮件配置

号码池设置

📊 验证安装

功能测试清单

前台功能测试

后台功能测试

邮件功能测试

性能优化建议

PHP配置优化

数据库优化

🚨 故障排除

常见安装问题

1. 环境检查失败

2. 目录权限错误

3. 数据库连接失败

4. URL重写问题

5. 会话问题

重新安装

📋 安装后检查清单

安全检查

功能检查

配置检查

📚 相关文档

🆘 获取帮助