auto-novel

一键翻译日文轻小说，追更不再等汉化

auto-novel 是一个开源的轻小说机翻网站，旨在帮助中文读者快速阅读日文轻小说。它支持网络小说、文库小说以及本地小说文件的翻译，用户可以通过网页界面直接输入小说链接或上传文件，利用 OpenAI 的 GPT 模型进行高质量翻译。项目采用 TypeScript 和 Kotlin 开发，前端基于 Vue，后端集成 ChatGPT API，提供流畅的翻译体验。核心能力包括自动抓取网络小说内容、批量翻译章节、保留原文格式、支持自定义翻译参数等。它解决了轻小说爱好者因语言障碍无法及时阅读最新作品的问题，降低了翻译成本和时间。

开源 unknown 对话助手

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 1177

维护状态较活跃

是否开源是

定价模式 unknown

项目数据

分类对话助手

开发团队auto-novel

所属国家

官网地址https://n.novelia.cc

GitHubhttps://github.com/auto-novel/auto-novel

定价模式unknown

价格说明定价信息待确认

访问状态

是否开源是

开源协议GPL-3.0

主要语言TypeScript

技术栈/模型chatgpt,kotlin,light-novel,openai,translator,vue

GitHub 星标★ 1177

30天Star增速

HF 下载量

上线时间2022-10-30 00:00:00

最近更新2026-09-23 00:00:00

维护状态较活跃

中文支持

访问方式

移动端支持

综合评分

收录时间2026-08-09

浏览次数2

使用教程

难度：进阶约 15 分钟部署方式：Docker 4 步

环境要求

已安装 Docker 与 Docker Compose
已安装 git
本地需可访问 localhost 的 80 端口
磁盘需预留 Elasticsearch 数据目录空间

安装与启动步骤

1克隆仓库

从 GitHub 拉取 auto-novel 源码到本地，并进入项目根目录，后续命令都在此目录执行。
```
git clone https://github.com/auto-novel/auto-novel.git
cd auto-novel
```

2生成环境变量

在项目根目录创建 .env 文件。个人部署只需关注代理与 Pixiv Cookie，留空也可启动。

cat > .env << EOF
HTTPS_PROXY=
PIXIV_COOKIE_PHPSESSID=

ACCESS_TOKEN_SECRET=
MAILGUN_API_KEY=
MAILGUN_API_URL=https://api.eu.mailgun.net/v3/verify.fishhawk.top/messages
MAILGUN_FROM_EMAIL=postmaster@verify.fishhawk.top
EOF

3创建数据目录

为 Elasticsearch 建好数据与插件目录并放开权限，否则容器可能因权限不足启动失败。
```
mkdir -p -m 777 ./data/es/data ./data/es/plugins
```
4启动服务

用 Docker Compose 后台拉起全部服务，首次拉取镜像与初始化耗时较久，请耐心等待。
```
docker compose up -d
```

关键配置

配置项	必填	说明	示例
`HTTPS_PROXY`	否	web 小说抓取代理，国内访问可填写，允许为空
`PIXIV_COOKIE_PHPSESSID`	否	Pixiv 登录 Cookie，用于爬取 P 站小说，可为空
`ACCESS_TOKEN_SECRET`	否	个人部署不需要填写，官方部署使用
`MAILGUN_API_KEY`	否	个人部署不需要填写，官方邮件验证使用
`MAILGUN_API_URL`	否	个人部署不需要填写，默认官方地址	`https://api.eu.mailgun.net/v3/verify.fishhawk.top/messages`
`MAILGUN_FROM_EMAIL`	否	个人部署不需要填写，邮件发件地址	`postmaster@verify.fishhawk.top`

如何确认成功

浏览器访问 http://localhost，能看到网站界面即部署成功。

常见问题

Q：启动后访问 localhost 打不开？

A：先执行 docker compose logs 查看容器状态，确认 80 端口未被占用、Elasticsearch 数据目录权限是否为 777。

Q：必须填写 OpenAI 或邮件相关配置吗？

A：README 中个人部署只需关注 HTTPS_PROXY 与 PIXIV_COOKIE_PHPSESSID，其余字段留空即可，不填也能启动。

Q：可以用于个人长期使用吗？

A：README 明确提示项目并非为个人部署设计，不保证所有功能可用和前向兼容。

Q：首次启动很慢怎么办？

A：需要拉取镜像并初始化 Elasticsearch，等待几分钟属正常；可用 docker compose ps 观察容器是否就绪。

注意事项

README 警告：本项目不是为个人部署设计，功能可用性与前向兼容无保证。
.env 中留空字段可以保留，但不要删除键名以免影响读取。
Elasticsearch 目录需 777 权限，否则容器可能启动失败。
生产环境请修改默认端口与访问控制，勿直接暴露公网。

核心亮点

支持多种小说来源（网络/文库/本地），覆盖全面
集成 GPT 模型，翻译质量优于传统机翻
提供 Web 界面，操作简单，无需编程知识

不足之处

依赖 OpenAI API，需要付费且国内访问受限
文档/社区待观察

适用场景

个人追更日文网络小说
批量翻译本地小说文件
搭建轻小说翻译分享站

替代项目

NovelAI、Sakura Translator、LunaTranslator

项目介绍

auto-novel 是行业应用领域的开源项目，由 auto-novel 开发，2022 年首次发布。

在全站 13,014 个收录项目中，它的 GitHub 星标数（1,177）位列前 30%，在行业应用分类中处于中上游。

近 45 天，它的 GitHub 星标从 1,090 增加到 1,177，净增 87。

项目保持着较活跃的维护节奏，最近一次代码更新于 2026-09-23。从国内网络环境看，当前已无法正常访问。

它主要面向的使用场景是：个人追更日文网络小说。同类可对比的替代方案包括 NovelAI、Sakura Translator、LunaTranslator。

上一篇：translate-shell

下一篇：ClicShopping