Jiangtokoto Server

一个高性能的表情包随机抽取 API 服务器。

特性

• 🚀 高性能异步 Web 框架 (基于 axum)
• 💾 内存缓存支持
• 🔄 CORS 支持
• 📝 YAML 配置
• 🔍 智能 MIME 类型检测
• ✨ 零拷贝文件传输
• 📊 内置监控和日志

快速开始

1. 环境要求

• Rust 1.70.0 或更高版本
• Cargo 包管理器

2. 配置

1. 复制配置文件模板：

   cp config.yml.example config.yml

2. 编辑 config.yml 配置文件：

# 服务器配置
server:
  # 服务器绑定的主机地址
  host: "0.0.0.0"
  # 监听的端口号
  port: 3000
  # 代理服务器配置
  proxy:
    # 是否启用代理头信息
    enabled: false
    # 获取真实IP的请求头
    ip_header: "x-forwarded-for"

# 日志配置 Logging Configuration
logging:
  # 日志文件目录
  directory: "logs"
  # 日志文件前缀
  file_prefix: "jiangtokoto"

# 存储配置 Storage Configuration
storage:
  # 表情包图片存储目录
  memes_dir: "assets/jiangtokoto-images/images"

# 缓存配置 Cache Configuration
cache:
  # 内存中缓存的最大图片数量
  max_size: 100
  # 缓存生存时间（秒）
  ttl_secs: 300

3. 构建和运行

# 构建项目
cargo build --release

# 运行服务器
cargo run --release

API 端点

获取随机表情包

GET /memes/random

响应:

• 200: 成功返回随机表情包
• 404: 未找到表情包
• 500: 服务器内部错误

健康检查

GET /memes/health

响应:

• 200: 服务正常

开发

目录结构

.
├── src/
│   ├── config/     # 配置管理
│   ├── handlers/   # 请求处理器
│   ├── models/     # 数据模型
│   ├── services/   # 业务逻辑
│   └── utils/      # 工具函数
├── assets/         # 静态资源
└── config.yml      # 配置文件

调试模式运行

RUST_LOG=debug cargo run

性能优化

服务器使用了多项性能优化技术：

• 异步 I/O
• 内存缓存
• 零拷贝文件传输
• 连接池优化

贡献指南

1. Fork 本项目
2. 创建新的功能分支
3. 提交更改
4. 创建 Pull Request

许可证

MIT License