# mcecyServer

**Repository Path**: jhjd/mcecy-server

## Basic Information

- **Project Name**: mcecyServer
- **Description**: 载途图床后台API
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2022-10-07
- **Last Updated**: 2025-08-12

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# MCECY 图床系统

MCECY是一个基于ThinkPHP 6.0开发的简洁、高效的图床系统，支持多用户管理、文件夹分类、图片上传与管理等功能。

## 功能特点

- **多用户系统**：支持用户注册、登录，每个用户拥有独立的存储空间
- **文件夹管理**：支持创建文件夹对图片进行分类管理
- **图片上传**：支持JPEG、PNG、JPG、WEBP等常见图片格式上传
- **空间管理**：自动统计用户已使用空间和剩余空间
- **图片查重**：基于MD5防止重复上传相同图片
- **友情链接**：支持在首页展示友情链接
- **CDN加速**：支持配置CDN地址，提升图片访问速度
- **WebSocket支持**：集成WebSocket服务，支持实时通知等功能

## 系统要求

- PHP 7.1+ (兼容PHP 8.0)
- MySQL 5.6+
- Composer
- Redis (可选，用于缓存)

## 安装教程

### 1. 获取源码

```bash
# 克隆项目
git clone https://github.com/yourusername/mcecy-server.git
cd mcecy-server

# 或者使用Composer创建项目
composer create-project topthink/think mcecy-server 6.0.*
```

### 2. 安装依赖

```bash
composer install
```

### 3. 配置环境

复制环境配置示例文件并修改为你的实际配置：

```bash
cp .env.sample .env
```

编辑`.env`文件，配置以下信息：
- 网站域名(HOST)
- CDN地址
- 数据库连接信息
- Redis配置(如需)
- 邮件服务配置(如需)

### 4. 导入数据库

创建数据库，并导入项目根目录下的SQL文件：

```bash
mysql -u用户名 -p密码 数据库名 < database.sql
```

### 5. 设置目录权限

确保以下目录可写：

```bash
chmod -R 755 runtime
chmod -R 755 public/uploads
chmod -R 755 public/storage
```

### 6. 配置Web服务器

#### Nginx配置

创建Nginx虚拟主机配置文件：

```nginx
server {
    listen 80;
    server_name your-domain.com;
    root /path/to/mcecy-server/public;
    index index.php index.html;
    
    # 代理WebSocket
    location /socket {
        proxy_pass http://127.0.0.1:9901;  # WebSocket服务监听地址
        proxy_set_header Host $host:$server_port;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
    }
    
    # 伪静态规则
    location / {
        if (!-e $request_filename) {
            rewrite ^(.*)$ /index.php?s=$1 last;
            break;
        }
    }
    
    # PHP处理
    location ~ \.php$ {
        fastcgi_pass unix:/var/run/php/php7.4-fpm.sock;  # 根据你的PHP版本调整
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
        include fastcgi_params;
    }
    
    # 禁止访问敏感文件
    location ~ /\. {
        deny all;
    }
}
```

#### Apache配置

如果使用Apache，确保开启了mod_rewrite模块，并在项目的public目录下创建或修改.htaccess文件：

```apache
<IfModule mod_rewrite.c>
  Options +FollowSymlinks -Multiviews
  RewriteEngine On
  RewriteCond %{REQUEST_FILENAME} !-d
  RewriteCond %{REQUEST_FILENAME} !-f
  RewriteRule ^(.*)$ index.php?s=$1 [QSA,PT,L]
</IfModule>
```

### 7. 启动WebSocket服务（如需）

```bash
php think socket:server
```

建议使用supervisor等工具保持WebSocket服务持续运行。

### 8. 访问网站

完成以上步骤后，访问你配置的域名，如果一切正常，你应该能看到MCECY图床系统的首页。

## 更新

如需更新框架，请执行：

```bash
composer update topthink/framework
```

## 常见问题

1. **上传失败**：检查目录权限和PHP上传限制
2. **无法访问**：检查伪静态配置是否正确
3. **WebSocket连接失败**：检查WebSocket服务是否正常运行

## 许可证

本项目采用MIT许可证，详情请查看LICENSE文件。

## 贡献

欢迎提交问题和贡献代码，请遵循项目的贡献指南。