安和鱼文档

IP 信息获取

安和鱼系统中的 IP 地址来源于 NSUUU API

系统未默认配置 API Token，你需要登录后台在

系统设置 -> 文章配置 里面配置 IP 属地查询 API 地址 以及 IP属地查询 API Token

请到 https://api.nsuuu.com 注册账户并获取 Key 后填写进来

反向代理配置

如果你使用 Nginx、Caddy 或其他反向代理，需要正确配置以传递客户端真实 IP，否则系统获取到的可能是代理服务器的 IP，导致 IP 定位不准确。

Nginx 配置

server {
    listen 80;
    server_name your-domain.com;

    location / {
        proxy_pass http://127.0.0.1:8080;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
}

Caddy 配置

Caddy 默认会自动传递这些头，无需额外配置：

your-domain.com {
    reverse_proxy localhost:8080
}

Docker Compose 配置

如果使用 Docker 部署并搭配 Nginx：

# docker-compose.yml
services:
  anheyu:
    image: anheyu/anheyu-app:latest
    ports:
      - "8080:8080"
    # ...其他配置

确保 Nginx 配置了正确的代理头（参考上方 Nginx 配置）。

CDN 配置

系统支持主流 CDN 服务的客户端 IP 识别：

CDN 服务	专用请求头	支持状态
Cloudflare	`CF-Connecting-IP`	✅ 支持
腾讯云 EdgeOne	`EO-Connecting-IP`	✅ 支持
阿里云 CDN/ESA	`Ali-CDN-Real-IP`	✅ 支持
通用代理	`X-Forwarded-For`	✅ 支持

Cloudflare

Cloudflare 默认传递 CF-Connecting-IP 头，无需额外配置。

如果你同时使用 Nginx，建议配置恢复真实 IP：

# 在 http 块或 server 块中添加
set_real_ip_from 103.21.244.0/22;
set_real_ip_from 103.22.200.0/22;
set_real_ip_from 103.31.4.0/22;
set_real_ip_from 104.16.0.0/13;
set_real_ip_from 104.24.0.0/14;
set_real_ip_from 108.162.192.0/18;
set_real_ip_from 131.0.72.0/22;
set_real_ip_from 141.101.64.0/18;
set_real_ip_from 162.158.0.0/15;
set_real_ip_from 172.64.0.0/13;
set_real_ip_from 173.245.48.0/20;
set_real_ip_from 188.114.96.0/20;
set_real_ip_from 190.93.240.0/20;
set_real_ip_from 197.234.240.0/22;
set_real_ip_from 198.41.128.0/17;
# IPv6
set_real_ip_from 2400:cb00::/32;
set_real_ip_from 2606:4700::/32;
set_real_ip_from 2803:f800::/32;
set_real_ip_from 2405:b500::/32;
set_real_ip_from 2405:8100::/32;
set_real_ip_from 2a06:98c0::/29;
set_real_ip_from 2c0f:f248::/32;

real_ip_header CF-Connecting-IP;

腾讯云 EdgeOne (EO)

EdgeOne 会自动传递 EO-Connecting-IP 头，系统已支持识别。

确保在 EdgeOne 控制台开启「回源时携带客户端 IP」功能。

阿里云 CDN/ESA

在阿里云 CDN 控制台配置：

进入 域名管理 -> 回源配置
开启 回源携带客户端真实 IP
选择请求头名称为 Ali-CDN-Real-IP

IP 识别优先级

系统按以下顺序识别客户端 IP：X-Forwarded-For → X-Real-IP → CF-Connecting-IP → EO-Connecting-IP → Ali-CDN-Real-IP → RemoteAddr

邮件配置

你可以登录后台在 系统设置 -> 邮件配置 里面配置 SMTP 相关配置

存储策略

在 系统设置 -> 存储策略 中配置文件存储方式。

支持的存储类型

存储策略	说明	适用场景
本机存储	存储在服务器本地	私有部署、小规模应用
OneDrive	微软 OneDrive 云存储	大容量云存储
腾讯云 COS	腾讯云对象存储	国内部署、CDN 加速
阿里云 OSS	阿里云对象存储	国内部署、CDN 加速
AWS S3	亚马逊 S3 及兼容服务	国际部署、S3 兼容

配置说明

本机存储：文件保存在 data/storage/ 目录，存储路径 /comments 对应 data/storage/comments/

OneDrive：需在 Azure 门户注册应用获取客户端 ID 和密钥，API 权限需包含 Files.ReadWrite.All 和 offline_access

云存储（腾讯云 COS/阿里云 OSS/AWS S3）：

推荐使用客户端直传方式，需配置 CORS 跨域规则
支持 CDN 加速和图片处理（样式分隔符）
按量计费

默认存储策略

系统内置两个默认策略，首次注册时自动创建：

article_image：文章图片存储
comment_image：评论图片存储

文件管理

系统存在两个默认文件夹，不支持删除。

comment_image: 评论图片 article_image: 文章图片

缩略图

系统支持为图片、视频、音频自动生成缩略图。

支持的文件类型

类型	格式	说明
图片	PNG、JPEG、GIF、WebP、BMP	内置处理引擎
视频	MP4、AVI、MOV、MKV、WebM	提取关键帧
音频	MP3、MP4、M4A、FLAC、OGG	提取专辑封面

生成方式

按需生成：查看文件时自动生成，不占用上传时间
手动生成：右键文件选择"重新生成缩略图"
批量生成：目录操作中选择"批量重新生成缩略图"

存储策略支持

存储策略	支持程度	说明
本机存储	✅ 完全支持	支持所有类型
腾讯云 COS	✅ 完全支持	支持所有类型
阿里云 OSS	✅ 完全支持	支持所有类型
AWS S3	✅ 完全支持	支持所有类型
OneDrive	⚠️ 有限支持	依赖 OneDrive 原生缩略图

提示

缩略图自动缓存，采用 LRU 算法管理。OneDrive 存储建议开启"缩略图代理生成"以获得完整支持。

静态资源自定义

使用 --export-assets 参数可以将内置的前端静态资源导出到指定目录，方便自定义修改：

# 社区版
./anheyu-app --export-assets ./static

# Pro 版（无需授权码）
./anheyu-pro --export-assets ./static

使用自定义资源

将导出的资源修改后，挂载到 /anheyu/static 目录即可：

# docker-compose.yml
volumes:
  - ./static:/anheyu/static

注意

配置指南