深耕数码兴趣领域
19
28
NAS 也能装下近几十万首诗：部署 Chinese Poetry API 全攻略
2026-07-16 11:11:21
0点赞
0收藏
0评论
在使用工具的时候有看到每日古诗的页面、刷网页也会跳出不同的古诗、对于这些场景我们一点也不陌生，如果你是一位开发者，想实现此功能，需要调用第三方服务，既然咱有了NAS，可以自己在NAS部署。今天分享的项目是Chinese Poetry API。
它是一款基于Go 语言开发的开源中国古诗词接口服务，将唐诗、宋词、元曲、诗经、楚辞、论语等古典文学数据整理成标准化 API，目前v0.6.0 数据库收录约 37.1 万首诗词、1.35 万位作者和 11 个朝代。本期文章就把它部署在NAS中。
一、功能体验
Chinese Poetry API是一个数据库的服务，它并不是一个古诗词网站，直接访问它可以看到相关的数据，但不像以前的羡慕直接通过web端直接使用，部署好之后，通过搭配Chinese Poetry API，才能得到更好的使用效果。文中展示的都是数据库呈现相关数据的效果。
在浏览器中输入NAS的ip+端口号+api/v1/poems/random可以查看相关的数据。
例：http://NAS的IP:1279/api/v1/poems/random
刷新之后就会换成别的诗
http://NAS的IP:1279/api/v1/poems/random?author=李白
还可以指定诗人随机抽取，需要将192.168.1.100换成自己NAS的ip，李白换成其他诗人名字。
玩法还有很多
比如按照作者朝代和诗的类型进行组合。
http://192.168.1.100:1279/api/v1/poems/random?dynasty=唐&type=七言绝句
或者抽取含有“月”的诗。
http://192.168.1.100:1279/api/v1/poems/random?char=月
二、威联通NAS部署
第一次部署时，遇到一些问题，数据库中没有诗词，所以后面我又手动将文件放到数据库中。先去项目作者的页面下载【poetry.db.gz】这个文件。
然后将下载的文件解压，并上传到NAS。
接着打开ContainerStation，点击【应用程序】→【创建】将下方的代码粘贴进去。
services:
poetry-api:
image: docker.1ms.run/palemoky/chinese-poetry-api:latest
container_name: poetry-api-v2
restart: unless-stopped
ports:
- "1279:1279"
environment:
TZ: Asia/Shanghai
PORT: "1279"
RATE_LIMIT_ENABLED: "true"
RATE_LIMIT_RPS: "10"
RATE_LIMIT_BURST: "20"
volumes:
- /share/Container/chinese-poetry-api/data:/app/data
接下来等待容器的安装。
Chinese Poetry API 支持部署在NAS，提供古诗词开放接口，能够对接各类诗词教学的平台，可以实现对业务二次开发与功能拓展。
