Explore
Topics
Collections
Documents
FAQ
GitHub
Explore repos
Explore
Topics
Collections
Documents
FAQ
GitHub
Explore repos
Explore
/
Java
/
so-novel
freeok ·
Trending
freeok/so-novel
小说下载｜网文下载 | 网络小说
View on GitHub
Copy link
Back to listing
8.4k
stars
750
forks
6
contributors
Java
README.md
View on GitHub
<div align="center"> <img src="assets/logo.png" style="width: 128px;"/> <h1 align="center">So Novel</h1> <h4 align="center"></h4> </div> <div align="center"> [](https://zread.ai/freeok/so-novel) [](https://github.com/freeok/so-novel/blob/main/LICENSE) [](https://github.com/freeok/so-novel/releases/latest) [](https://github.com/freeok/so-novel/releases/latest) </div> ## 概述 **So Novel** 是一款通用的网页内容处理与导出工具，它致力于帮助用户高效地从网页中提取结构化信息，并将其灵活导出为 EPUB、TXT、PDF 等多种标准电子文档格式。适用于学习采集、格式转换、电子书制作等场景。 ## 预览 <details> <summary>点击查看图片</summary> ### TUI 预览 (Text-based User Interface)  ### WebUI 预览 (网页版)  ### CLI 预览 (Command Line Interface)  </details> ## 安装 ### 📦 手动下载压缩包 <https://github.com/freeok/so-novel/releases> ### 🪟 Windows #### 1. PowerShell ```powershell # powershell irm https://raw.githubusercontent.com/freeok/so-novel/main/bin/windows-install.ps1 | iex ``` #### 2. CMD (命令提示符) ```cmd powershell -NoProfile -ExecutionPolicy Bypass -Command "irm https://raw.githubusercontent.com/freeok/so-novel/main/bin/windows-install.ps1 | iex" ``` ### 🐧 Linux ```bash bash <(curl -sSL https://raw.githubusercontent.com/freeok/so-novel/main/bin/linux-install.sh) ``` ### 🍺 Homebrew ```bash brew tap ownia/homebrew-ownia # https://docs.brew.sh/Tap-Trust#why-tap-trust-exists brew trust --formula ownia/homebrew-ownia/so-novel brew install so-novel ``` ### 🍨 Scoop ```bash scoop bucket add freeok https://github.com/freeok/scoop-bucket scoop install freeok/so-novel ``` ### 🐳 Docker **方式 1: 脚本一键安装** ```bash curl -sSL https://raw.githubusercontent.com/freeok/so-novel/main/bin/docker-install.sh | bash ``` **方式 2: Docker Compose (NAS 首选)** ```yaml services: sonovel: image: ghcr.io/freeok/sonovel:latest container_name: sonovel ports: - "7765:7765" environment: JAVA_OPTS: "-Dmode=web" volumes: - sonovel_data:/sonovel restart: unless-stopped volumes: sonovel_data: ``` **方式 3: Docker Run** ```bash # 如需挂载，请提前准备好 config.ini 文件、rules 目录 docker run -d \ --name sonovel \ -v /sonovel/config.ini:/sonovel/config.ini \ -v /sonovel/rules:/sonovel/rules \ -v /sonovel/downloads:/sonovel/downloads \ -p 7765:7765 \ -e JAVA_OPTS='-Dmode=web' \ ghcr.io/freeok/sonovel:latest ``` **从源码构建 Docker 镜像** ```bash # 确保已安装 git、jdk 21、maven sudo apt update sudo apt install -y git sudo apt install -y openjdk-21-jdk sudo apt install -y maven # 验证安装 git -v javac -version mvn -v # 构建项目 git clone https://github.com/freeok/so-novel.git && cd so-novel # arch: [x64|arm64] sh bin/release-linux.sh [arch] # 构建 Docker 镜像 cp -r target/sonovel-linux_[arch]/{app.jar,config.ini,rules} . docker build -t sonovel . ``` > [!TIP] > > 为获得最佳阅读体验，建议使用以下电子书阅读器： > > **桌面端** > > - [Readest](https://readest.com/) > - [Koodo Reader](https://www.koodoreader.com/zh) > - [Calibre](https://calibre-ebook.com/) > - [Neat Reader（网页版）](https://www.neat-reader.cn/webapp) > > **移动端** > > - [Readest](https://readest.com/) > - [Apple Books](https://www.apple.com/apple-books/) > - [Moon+ Reader（静读天下）](https://moondownload.com/chinese.html) > - [Kindle](https://apps.apple.com/us/app/amazon-kindle/id302584613) > > 如需转换为其它电子书格式，可使用： > > - [FreeConvert](https://www.freeconvert.com/zh) > - [Calibre](https://calibre-ebook.com/zh_CN) > > 修复 WPS、掌阅等软件无法打开 so-novel 下载的 EPUB：https://github.com/freeok/so-novel/discussions/199 ## 自定义 JVM 系统属性 | 参数 | 说明 | 默认值 | |---------------|------------------------|--------------| | -Dmode | 启动模式，可选值：tui\|cli\|web | tui | | -Dconfig.file | 配置文件路径 | ./config.ini | 用法 > [!NOTE] > > Windows 修改 [sonovel.l4j.ini](bundle/sonovel.l4j.ini) > > Linux 修改 [run-linux.sh](bundle/run-linux.sh) > > macOS 修改 [run-macos.sh](bundle/run-macos.sh) ## 使用本地 JDK / JRE 启动 如果你不想使用内置 JRE（runtime 目录），可以通过本地 JDK / JRE 启动程序 Windows 使用脚本 start-custom-jre.cmd： ```cmd REM -------------------------------------------------- REM 高级用户使用自定义 JRE 启动程序 REM 将 "your_path\java.exe" 替换为你的 JRE 路径，例如： REM "C:\Java\jdk-21\bin\java.exe" REM -------------------------------------------------- @echo off your_path\java.exe ^ -XX:+UseZGC ^ -XX:+ZGenerational ^ -Dconfig.file=config.ini ^ -Dmode=tui ^ -Dfile.encoding=GBK|Big5 ^ -jar app.jar ``` Linux / macOS：[run-linux.sh](bundle/run-linux.sh) / [run-macos.sh](bundle/run-macos.sh) 修改 java 路径 ## 常见问题 https://github.com/freeok/so-novel/issues?q=label%3A%22usage%20question%22 ## 讨论 https://github.com/freeok/so-novel/discussions?discussions_q= ## 支持 & 赞助 如果觉得有所帮助，欢迎扫码赞助☕、点击项目主页顶部的⭐Star 按钮支持！ 🚀这将是我们持续更新的动力源泉！同时，你也能第一时间获取到最新的更新动态。💡❤️ | 支付宝赞助 | 微信赞助 | |-----------------------------------------------------------------|----------------------------------------------------------------| | <img src="assets/donation-alipay.png" alt="支付宝收款码" width="197"> | <img src="assets/donation-wechat.jpg" alt="微信赞赏码" width="197"> | [项目赞助者列表](./SPONSORS.md) ## 免责声明 在使用本工具前，请务必仔细阅读我们的[法律免责声明](bundle/DISCLAIMER.md)。使用本工具即表示您已阅读、理解并同意遵守所有条款。 ## Star History [](https://www.star-history.com/?repos=freeok%2Fso-novel&type=date&legend=top-left)
Live Chat
