# 二次元图床

**Repository Path**: hs223/tuchuang

## Basic Information

- **Project Name**: 二次元图床
- **Description**: 基于 icret/EasyImages2.0 二次开发的图床程序： 无数据库、支持多图上传与拖拽 / Ctrl+V 粘贴，返回图片直链、Markdown、BBCode、HTML 链接。 本仓库在官方版本基础上把界面改成了二次元樱花风格（透明玻璃 + 樱花粉 + 壁纸背景）。
- **Primary Language**: PHP
- **License**: GPL-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 18
- **Created**: 2026-11-03
- **Last Updated**: 2026-11-04

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 二次元图床 · EasyImages 2.0 二次开发版

> 基于 [icret/EasyImages2.0](https://github.com/icret/EasyImages2.0) 二次开发的图床程序：
> 无数据库、支持多图上传与拖拽 / Ctrl+V 粘贴，返回图片直链、Markdown、BBCode、HTML 链接。
> 本仓库在官方版本基础上把界面改成了**二次元樱花风格**（透明玻璃 + 樱花粉 + 壁纸背景）。

🌐 线上运行：<https://tuchuang.syuii.com>

---

## 界面特点（本仓库二改部分）

- **一屏居中的大上传框**：打开即是半屏高的虚线框，拖拽 / 粘贴 / 点按钮都行，无需滚动
- **二次元樱花皮肤**：樱花粉 → 淡紫渐变、毛玻璃质感、圆角胶囊按钮、圆角 26px 上传框
- **上传框 hover 动效**：鼠标移上去从 16% 透明变为近实底白，上浮 + 粉色光晕
- **全站透明化**：按钮条 / 标签面板 / 页脚都不再有白色底板，壁纸完整透出
- **可选壁纸背景**：放一张 `public/static/bg.jpg` 即可自动生效；没有就显示柔光渐变
- **响应式**：手机上上传框自动变矮、按钮不会被挤出屏幕
- **无推广**：页脚、公告中的第三方推广链接与打赏按钮已移除（保留 GPL 署名）

---

## 二改清单（与上游的差异）

| 文件 | 改动 |
|---|---|
| `index.php` | 首页主区域加 `id="home-hero"`，用于一屏居中布局 |
| `app/header.php` | 引入皮肤样式 `public/static/custom.css?v=5` |
| `public/static/custom.css` | **新增**：二次元樱花皮肤（约 14.6 KB，含注释） |
| `.gitignore` | **新增**：忽略 `config/config.php`、上传图片、日志等运行数据 |
| 后台配置 | 标题 / 公告 / 页脚 / 登录背景 / 进度条配色（存 `config/config.php`，不入库） |

> 皮肤全部集中在 `custom.css`，想换颜色只需要改文件顶部的 CSS 变量，**不用动任何 PHP 逻辑**。

---

## 继承自 EasyImages 2.0 的功能

- 无数据库，环境要求极低（PHP 5.6 即可跑，推荐 7.x / 8.x）
- 多文件上传、拖拽上传、粘贴上传、大图上传
- 返回图片直链 / Markdown / BBCode / HTML / 缩略图 / 删除链接
- 支持 API 上传（PicGo、ShareX、uPic、Chrome/Edge 插件等）
- 图片压缩、质量设置、格式转换、文字 / 图片水印、宽高限制
- 在线管理图片、广场、历史上传、统计图表
- 上传 IP 黑白名单、日上传次数限制、仅登录后上传、仅上传用户
- 支持 FTP / 对象存储等远程附件，支持鉴黄

---

## 环境要求

- PHP **≥ 5.6**（推荐 7.4 / 8.0 以上）
- PHP 扩展：`fileinfo`、`gd`、`openssl`（建议同时开启 `iconv`、`zip`、`mbstring`）
- Web 服务器：Nginx（宝塔）或 Apache
- 目录可写：`i/`（图片目录）、`config/`（安装时写入配置）

---

## 部署（宝塔面板）

1. 新建站点，把本仓库代码放到站点根目录（有 `index.php` 那层）
2. 网站设置 → PHP 版本：选择 7.4 或更高；软件商店 → PHP → 设置 → 安装扩展 `fileinfo`、`gd`
3. **网站设置 → 网站目录 → 关闭「防跨站攻击(open_basedir)」**，并删除根目录残留的 `.user.ini`
   （EasyImages 安装检测到 `.user.ini` 会拒绝安装）
4. 权限：所有者 `www:www`，目录 755、文件 644，`app/upload.php` 755，`i/` 可写
5. 浏览器访问 `https://你的域名/install/`，按提示完成安装
6. 安装完成后**删除 `install/` 目录**；如需重装，删除 `config/install.lock` 后再访问 `/install/`
7. 后台「设置 → 界面设置」：**关闭暗黑模式**、登录背景可填 `/public/static/bg.jpg`

> 从本仓库部署时，`config/config.php` 是空白模板；你自己的配置在服务器上，**不要覆盖**。

---

## 自定义皮肤（换色 / 换壁纸）

打开 `public/static/custom.css`，顶部是全部可调参数：

```css
:root {
  --brand: #ff8fcf;        /* 主色：樱花粉（可换 #7ec8ff 天空蓝 / #b39ddb 薰衣草紫） */
  --brand-2: #9b8cff;      /* 渐变辅助色 */
  --glass: rgba(255,255,255,.16);      /* 上传框平时透明度 */
  --glass-strong: rgba(255,255,255,.88); /* hover 后的不透明度 */
  --col: 940px;            /* 内容列宽 */
}
```

- **换壁纸**：上传图片到 `public/static/bg.jpg`，会自动垫在渐变层下面
- **壁纸浓度**：改 `body.container` 里 `linear-gradient(... .78 ...)` 的透明度（越小壁纸越清晰）
- **上传框高度**：改 `min-height: 46vh`（桌面）/ `34vh`（手机）
- **改完记得给缓存版本号 +1**：`app/header.php` 中 `custom.css?v=5` → `?v=6`

---

## 目录结构（主要部分）

```
index.php              首页（上传 + 结果标签页）
admin/                 后台（登录 / 设置 / 统计 / 文件管理）
app/                   核心逻辑（upload.php 上传、function.php 公共函数、header/footer）
config/                配置（config.php 为安装生成，含账号与密钥，不入库）
docs/                  文档
i/                     上传的图片目录（不入库）
install/               安装程序（装完请删除）
public/static/         静态资源与皮肤 custom.css
```

---

## 文档

上游文档可直接参考（本仓库保留 `docs/`）：

- [安装图床](docs/安装图床.md) · [安全配置](docs/安全配置.md) · [API](docs/API.md)
- [图床更新升级](docs/图床更新升级.md) · [常见问题](docs/常见问题.md) · [其他格式](docs/其他格式.md)
- [使用 PicGo 上传](docs/使用PicGo上传.md) · [使用 ShareX 上传](docs/使用ShareX上传.md)

---

## 更新记录

### 2026-11-04 首次二改

- 首页改为「一屏居中大上传框」（`index.php` + `custom.css`）
- 新增二次元樱花皮肤，全站透明玻璃化、边缘对齐、hover 动效
- 页面公告 / 弹窗公告 / 页脚 / 管理提示文案重写
- 移除页脚与公告中的第三方推广、打赏入口（保留 GPL 署名）
- 新增 `.gitignore`，配置与图片不再误入仓库

---

## 开源许可

- 本项目基于 [icret/EasyImages2.0](https://github.com/icret/EasyImages2.0) 修改，遵循 **[GPL-2.0](LICENSE)**。
- 原项目 Copyright © 2018 EasyImage Developer By [Icret](https://github.com/icret)。
- 本仓库为个人二次开发版本，**与上游不保证同步**；上游更新可用 `git merge upstream/master` 跟进。
- 修改过的文件：`index.php`、`app/header.php`；新增文件：`public/static/custom.css`、`.gitignore`。
- 请勿删除 `LICENSE` 与本段署名，二次分发时同样需以 GPL-2.0 开源。

## 免责声明

本项目仅供学习与个人自用。使用者需自行承担部署与运营责任，不得用于违法违规用途；
因使用本程序产生的内容与法律问题与原作者及本仓库维护者无关。