詩泉：一个高性能古诗词 API 服务

项目基于开源 chinese-poetry 诗词数据集，收录近 40 万首古典诗词，支持简体、繁体切换。内置 SQLite FTS5 全文检索，提供 RESTful API 与 GraphQL 两套查询方案，自带飞花令、随机诗词、多条件筛选、分页查询等能力。

服务支持 Docker 一键部署，适配 amd64/arm64 架构，内置访问限流，可直接私有化部署，适用于诗词网站、小程序、AI 配套工具等场景。

核心特点

• 高性能: Go 语言编写，支持并发处理，性能优化（简繁转换 ~300ns/op）
• 海量数据: 包含唐诗、宋词、元曲等近 40 万首诗词
• 强大搜索: 支持全文搜索、标题/内容/作者分类搜索
• 双语支持: 同一数据库同时存储简体和繁体中文，通过 ?lang= 参数切换
• 多种接口: REST API 和 GraphQL 双接口支持
• 限流保护: 内置 IP 限流，防止滥用
• 容器化: Docker 镜像开箱即用，支持多架构（amd64/arm64）
• 智能分类: 按朝代、作者、诗词类型自动分类

快速开始

使用 Docker（推荐）

docker run -d -p 1279:1279 palemoky/chinese-poetry-api:latest

Docker Compose

services:
  poetry-api:
    image: palemoky/chinese-poetry-api:latest
    container_name: poetry-api
    restart: unless-stopped
    env_file: .env
    ports:
      - "${PORT:-1279}:${PORT:-1279}"
    environment:
      - TZ=Asia/Shanghai
      # Optional: Override database connection pool (default: auto-detect based on CPU cores)
      # - DB_MAX_OPEN_CONNS=20
      # - DB_MAX_IDLE_CONNS=10
    volumes:
      - poetry-data:/app/data

volumes:
  poetry-data: