Manga_service 一键搭建自己的漫画服务器

d8349565

完善和重做了去年做的漫画服务，提升了阅读体验和各项功能。

下载:https://leezfy.lanzouq.com/iwH932id50nc 密码:2bxc


截图展示：

Manga_service

这是一个基于 FastAPI 开发的漫画网站后端服务，提供漫画内容管理、用户管理、阅读进度追踪等功能。

项目主要是把采集到的漫画数据通过网页加载阅读，可在同WiFi局域网内的电脑、平板、手机等各类设备上看漫画。

仅用于交流学习，勿做他用。

主要功能

1. 用户系统

• 用户注册与登录(登入页面：http://localhost:8812/static/login.html)
• 用户 token 认证
• 用户角色管理(普通用户/管理员)

2. 漫画管理

• 通过爬虫将漫画数据导入数据库，数据库结构如下：

[User] 用户表
├── id: Integer (PK)
├── email: String (唯一索引)
├── hashed_password: String
├── role: Enum(admin/user)
└── is_active: Boolean
[Comic] 漫画表
├── id: Integer (PK)
├── title: String (索引)
├── author: String
├── description: Text
└── cover_image: String
[Chapter] 章节表
├── id: Integer (PK)
├── comic_id: Integer (FK -> Comic.id)
├── chapter_number: Integer
├── title: String
└── images: Text (JSON)
[ReadingProgress] 阅读进度表
├── id: Integer (PK)
├── user_id: Integer (FK -> User.id)
├── comic_id: Integer (FK -> Comic.id)
├── chapter_id: Integer (FK -> Chapter.id)
├── scroll_position: Float
└── last_read_at: DateTime
关系:
Comic 1:N Chapter (一本漫画有多个章节)
User N:M Comic (通过 ReadingProgress 多对多关联)
Chapter 1:N ReadingProgress (一个章节可以被多个用户阅读)

3. 阅读功能

• 漫画阅读器
• 支持PWA，实现添加到主屏幕功能
• 阅读进度自动保存
• 支持章节导航(上一章/下一章)
• 阅读历史记录
• 缓存
• ......

技术特点

• 基于 FastAPI 框架开发
• SQLite 数据库存储（其他分支为 MySQL 数据库版本）
• Docker 容器化部署
• 异步处理
• 清华镜像源加速

项目结构

backend/
├── app/
│   ├── api/            # API 路由
│   ├── core/           # 核心配置
│   ├── db/             # 数据库相关
│   ├── models/         # 数据模型
├── static/             # 静态文件
│   ├── admin.html      # 管理后台页面
│   ├── comics.html     # 漫画列表页面
│   ├── chapters.html   # 章节列表页面
│   ├── login.html      # 登录页面
│   ├── reader.html     # 阅读器页面
│   └── manifest.json   # PWA配置文件
├── Dockerfile          # Docker 配置
└── docker-compose.yml  # Docker Compose 配置

快速开始

使用 Docker 部署

1. 构建并启动服务：

   git clone https://github.com/d8349565/manga_service.git
   cd backend
   docker-compose up -d

2. 服务将在 8812 端口启动

本地开发

1. 安装依赖：

   pip install -r requirements.txt

2. 运行服务：

   cd backend
   python main.py

API 接口

认证相关

• POST /api/auth/register - 用户注册
• POST /api/auth/login - 用户登录
• GET /api/auth/me - 获取当前用户信息

漫画相关

• GET /api/comics - 获取漫画列表
• POST /api/comics - 创建新漫画
• GET /api/comics/{comic_id} - 获取漫画详情
• DELETE /api/comics/{comic_id} - 删除漫画

章节相关

• GET /api/comics/{comic_id}/chapters - 获取章节列表
• POST /api/comics/{comic_id}/chapters - 创建新章节
• GET /api/chapters/{chapter_id} - 获取章节详情

阅读相关

• GET /api/reader/comics/{comic_id}/read/{chapter_id} - 获取阅读内容
• GET /api/reader/comics/{comic_id}/progress - 获取阅读进度
• POST /api/reader/progress - 更新阅读进度
• GET /api/reader/history - 获取阅读历史

数据存储

• 用户数据、漫画信息存储在 SQLite 数据库中（web 分支为MySQL 数据库版本）
• 使用 Docker volume 持久化数据

注意事项

1. 首次使用需要重新注册管理员账户密码（默认为 账户 admin 密码 admin）
2. docker 部署、内网穿透、域名、ddns 等设置请自行搜索完成。
3. github项目地址：https://github.com/d8349565/manga_service

d8349565

healwilson 发表于 2024-12-19 10:43
大佬打个包传到dockerhub上啊，现在这个小白不会用

直接本地Python运行也可以的：

[Shell] 纯文本查看 复制代码

cd backend
pip install -r requirements.txt
python main.py

d8349565

SherlockProel 发表于 2024-12-18 11:52
我之前追过一个韩漫挺好看，后来那个app凉了，怎么都找不到那个资源了，剧情大概是男主小时候家里出车祸就 ...

相亲相爱一家人

d8349565

xingxiaofei 发表于 2024-12-21 21:31
群晖上面弄了一个~ 感觉还不错~ 电脑的还没弄 先收藏了 以后玩玩 谢谢分享

nas 的话去使用 MySQL 版本，方便爬数据写入

z763326786

d8349565 发表于 2024-12-20 10:05
z763326786 发表于 2024-12-20 08:28
docker容器中如何添加~有没有操作教程
git clone git clone git clo ...

研究了一中午终于添加成功了，先上传到服务器目录，打开docker compose 然后添加上传的目录，将默认脚本的路径修改好，点击启动就成功了

李大壮

SherlockProel 发表于 2024-12-18 11:52
我之前追过一个韩漫挺好看，后来那个app凉了，怎么都找不到那个资源了，剧情大概是男主小时候家里出车祸就 ...

🈲漫天堂

libin302010

好东西，支持一下楼主

d8349565

zhaojianju 发表于 2024-12-23 13:19
宝塔面板如何操作？请大佬解惑

你直接部署1panel吧，通过1panel操作docker很方便。

6952350

好东西，支持一下楼主

GLDragon

等我学会，先收藏吃灰

zhaojianju

宝塔面板如何操作？请大佬解惑

kestrel

感谢分享，客户端用啥

xianshi789

感谢分享！学习学习原理。

qfhd

感谢分享，有空学习搭建一下。

d8349565

langjuxv 发表于 2024-12-22 20:25
有服务器，那漫画内容从哪里弄到服务器上呢？

爬虫对接数据库进行更新，还在整理...