O96u
ff20f97522
Add slider captcha for web login, VitePress documentation on GitHub Pages, and fixes for gallery delete refresh, pagination jump, and copy-format persistence.
54 lines
1.5 KiB
Markdown
54 lines
1.5 KiB
Markdown
# Twikoo
|
||
|
||
PicHost 兼容 **Twikoo** 与 **EasyImage 2.0** 图片上传协议，评论系统可像接 EasyImage 一样配置。
|
||
|
||
## Twikoo 配置
|
||
|
||
在 Twikoo 环境变量或配置中设置：
|
||
|
||
| 配置项 | 值 |
|
||
| ------ | -- |
|
||
| `IMAGE_CDN` | `easyimage` |
|
||
| `IMAGE_CDN_URL` | `https://你的域名/api/index.php` |
|
||
| `IMAGE_CDN_TOKEN` | 与全局 `API_UPLOAD_TOKEN` 相同 |
|
||
|
||
- 使用 **网站域名**（管理后台域）作为 `IMAGE_CDN_URL` 的主机名
|
||
- Token 需在 PicHost **API** 页生成，或通过 `API_UPLOAD_TOKEN` 环境变量设置
|
||
|
||
## 上传接口
|
||
|
||
`POST /api/index.php`
|
||
|
||
表单字段：
|
||
|
||
| 字段 | 说明 |
|
||
| ---- | ---- |
|
||
| `image` | 图片文件 |
|
||
| `token` | 全局 API Token（与 `Auth-Token` 等效） |
|
||
|
||
```bash
|
||
curl -X POST "https://admin.example.com/api/index.php" \
|
||
-F "token=YOUR_TOKEN" \
|
||
-F "image=@./demo.png"
|
||
```
|
||
|
||
上传的图片存入 `images/` 目录，归属与 **全局 Token** 相同（管理员）。
|
||
|
||
## 与 REST API 的区别
|
||
|
||
| 项目 | REST `/api/images/upload` | Twikoo `/api/index.php` |
|
||
| ---- | ------------------------- | ------------------------ |
|
||
| 鉴权 | `Auth-Token` 请求头 | 表单 `token` |
|
||
| 响应格式 | PicHost JSON | EasyImage 兼容 JSON |
|
||
| Token | 全局或个人 | 仅全局 Token |
|
||
|
||
## 双域名部署
|
||
|
||
Twikoo 上传应走 **网站域名**（`SITE_BASE_URL`），图片展示走 **图片域名**（`IMAGE_BASE_URL`）。详见 [双域名分离](./domain-separation.md)。
|
||
|
||
## 相关
|
||
|
||
- [API](./api.md)
|
||
- [用户与权限](./users-and-permissions.md)
|
||
- [环境变量](./configuration.md)
|