不用纠结“漫荒”这个词是不是听着有点老二次元。我自己的收藏习惯是——本地硬盘里堆着几百G从各种渠道整理来的漫画文件包括多年攒的 CBZ、CBR、PDF还有按作者分好的目录。以前每次想翻一本都得先开电脑、挂载磁盘、找合适的阅读器折腾十五分钟最后往往不想看了。更别说出门在外地铁上想翻两页手机里却只有那几部反复刷过的缓存。后来我花了两个晚上把 Teemii 和 cpolar 组合起来搭了一个真正可以“随身带着走”的私人漫画库。Teemii 负责把散落在硬盘里的漫画文件统一管理成漂亮的在线书架cpolar 负责把家里这台服务器安全地暴露到公网。这套东西跑起来之后我手机浏览器打开固定地址就能直接翻全部收藏速度还过得去刮削封面、阅读进度同步、多人都能用。这篇文章就把我的完整搭建过程、踩过的坑、以及调试技巧全部写出来。1. 为什么是 Teemii cpolar这套方案的底层逻辑先说清楚一件事Teemii 并不是唯一一个能搭私人漫画库的工具。市面上一堆开源项目都能干这事比如某几个知名群晖套件、一些老牌的漫画管理面板。但 Teemii 有几个点特别对我的胃口和 cpolar 搭配起来也最顺手。1.1 自托管漫画服务器的核心价值自托管的意思很简单软件跑在你自己的设备上数据也在你自己的硬盘里。你不需要把漫画上传到任何第三方平台也不依赖某个平台今天还活着、明天突然宣布下架某个系列。我吃过不少亏之前在某在线阅读平台充了会员结果想看的几部漫画因为版权问题直接下架钱退不回来书也看不成了。从那以后我就明白一个道理——凡是真正想长期收藏的东西必须放在自己能碰到的存储里。Teemii 做的是把“一堆文件”变成“一个书架”。它支持常见的 CBZ、CBR、PDF 等格式能自动读取压缩包里的图片帮你生成缩略图还能从公共元数据源抓取封面、作者、简介、标签。这一点非常重要因为自己手动整理几百部漫画的元数据工作量大到能直接劝退。Teemii 的刮削能力虽然不算顶级聪明但配合规范的目录命名准确率相当可观。和群辉上那些偏重下载功能的方案相比Teemii 完全是冲着阅读体验去的。它的网页端阅读器做得很像主流漫画 App支持双页模式、滚轮缩放、方向切换还带阅读进度记忆。也就是说你在手机上读到第 35 页下次打开同一本书它会直接回到第 35 页这个体验对追连载或者看长篇章太重要了。1.2 cpolar 在整套方案里的角色Teemii 默认跑在你内网里的某个端口上比如 127.0.0.1:3000 或者局域网 IP:3000。在家连 WiFi 倒是能访问但一出门就废了。这时候有三种解决思路第一种是租一台云服务器把 Teemii 部署上去第二种是用路由器端口映射把家里的端口暴露出去第三种就是用内网穿透工具也就是 cpolar。云服务器方案省心但漫画存储是个大问题。几百G的漫画文件要传到云服务器上不光是上传时间的问题每月的流量计费和磁盘扩容费用都很可观。你租一台 2C4G 的轻量服务器系统盘顶多几十G根本塞不下收藏还得单独买 NAS 或者对象存储整个架构一下子就重了。路由器端口映射的问题更直接——大部分家庭宽带没有公网 IP或者运营商做了 NAT 隔离你映射了也没用。就算有公网 IP动态 IP 每次重启路由都会变你还得去弄 DDNS而且直接把端口裸奔到公网安全风险也不小。cpolar 做的事情是把你在内网里跑着的 Teemii 服务通过一条加密隧道接到 cpolar 的边缘节点上然后给你一个可以公网访问的域名。外部用户访问那个域名时流量会通过隧道转发到你家里的 Teemii 服务上。整个过程不需要公网 IP不需要租云服务器不需要改路由器设置。数据链路是加密的比直接端口映射要安全得多。我最终选 cpolar 还有一个很实际的原因——它有一个免费套餐对自托管玩家来说先零成本把整套流程跑通、确认体验可以接受再考虑要不要升级付费套餐。很多内网穿透工具免费版限制了一堆功能cpolar 的免费版至少能让你完整体验到“公网访问自托管服务”这件事。1.3 对比其他方案的取舍记录我也试过只用局域网访问配合 JuiceSSH 做端口转发但手机上要额外装 App每次建立连接都要手动操作家里人根本学不会。也试过直接在某云厂商买一台入门级 VPS装好 Teemii 后传了几部漫画发现小带宽下图片加载慢得让人崩溃传文件还占流量费用实在不值得。最后这套组合的取舍逻辑很清晰Teemii 放在家里闲置的小主机或 NAS 上存储成本为零空间随便加硬盘就扩容。cpolar 解决外网访问问题免费套餐已经能跑通核心链路付费套餐则是提供固定域名和更多带宽。手机端不需要装任何客户端用浏览器访问就行跨平台体验一致。这套方案最适合三种人手里已经有一定存量漫画文件的老收藏党想给家里孩子做一个受控阅读环境、但家里网络条件一般的家长喜欢折腾自托管服务、但不想在这件事上长期花钱的技术爱好者。2. Teemii 部署与漫画库初始化Teemii 的部署本身没有太多弯弯绕绕官方推荐用 Docker Compose 的方式跑。下面把我最终的配置、目录结构和初始化过程写清楚。2.1 Docker 部署与目录规划我在家里那台小主机上预先装好了 Docker 和 Docker Compose 插件。目录结构我是这样规划的./teemii/ ├── docker-compose.yml ├── data/ │ ├── config/ # 配置文件和数据库 │ └── library/ # 漫画文件总目录 │ ├── 按作者/ │ │ ├── 作者A/ │ │ │ └── 作品名.cbz │ │ └── 作者B/ │ │ └── 作品名.cbr │ └── 待整理/docker-compose.yml 我用了比较保守的写法确保重启后容器不会因为实验性配置起不来。version: 3.8 services: teemii: image: teemii/teemii:latest container_name: teemii restart: unless-stopped ports: - 3000:80 volumes: - ./data/config:/app/config - ./data/library:/app/library environment: - TZAsia/Shanghai有几个细节值得专门提一下。第一容器内 Teemii 的 Web 服务默认端口是 80但我不喜欢用默认端口直接暴露在宿主机上所以映射成了宿主机的 3000。这样以后如果还想跑别的服务端口不容易冲突。第二映射目录一定要用相对路径或者绝对路径写清楚千万别用匿名卷。如果忘了映射 config 目录容器一升级重装你的书架配置和阅读进度全部归零。我身边已经不止一个人踩过这个坑了。第三TZ 环境变量一定要设置。如果不设置有些元数据刮削服务返回的时间字段会和你本地时间差 8 个小时虽然影响不大但看着日志里那个 UTC 时间总觉得别扭。2.2 漫画元数据刮削的细节Teemii 初始化完成后第一次打开管理后台会让你先建一个管理员账号。然后进入“Library”设置把 /app/library 这个路径挂载进去让它开始扫描。这里有个非常重要的经验——漫画文件的命名规范直接决定了刮削的命中率。我自己实测下来比较靠谱的命名格式是两层一层是“作者名/作品名”或者一层是“作品名”直接放根目录。Teemii 对单卷本的识别还行对多卷本有点吃力。比如你有一个文件夹名为“某长篇连载”里面放着“第01话.cbz”“第02话.cbz”这种文件Teemii 默认会当成一个系列自动聚合但是如果断更、中间缺了几话聚合逻辑就可能混乱。扒刮削源的问题也要说一句。Teemii 支持配置多个元数据源默认配置里有一个公共的漫画数据库源国内网络环境下偶尔会请求超时。如果刮削不出封面不用急着骂软件先看日志里是网络问题还是识别问题。网络问题可以重试几次或者错峰刮削。我习惯的做法是分批次刮削不要一次性丢进去几千本。一次性刮削时Teemii 会同时请求大量元数据公共数据库源很容易限流然后就会出现一堆“封面加载失败”的条目。分批操作虽然慢但胜在稳定。对了CBZ 和 CBR 的文件格式其实是有讲究的。CBZ 本质是 ZIP 压缩包CBR 本质是 RAR 压缩包。Teemii 对这两种格式的支持都还行但如果你的上级文件夹是中文名且层级特别深某些版本的 RAR 解析会有兼容性问题最好把漫画文件放在不超过三层的目录里。2.3 多用户与阅读权限配置Teemii 默认是支持多用户的这意味着你就不用把账号密码共享给家里所有人了。建好管理员账号之后我建议立刻在设置里关掉“允许匿名访问”否则任何知道地址的人都能直接进来读你的漫画库。添加新用户时可以设置该用户可访问的库范围。比如给小朋友开的账号只开放一个“儿童专区”文件夹的权限这样既能控制内容又不用你去手动删减文件。这个功能特别适合家庭场景尤其是有小孩的家庭——你总不希望孩子自己翻到一些不适合的题材。权限配置的核心原则就是管理员账号日常不要用来阅读只在整理书库时用自己出门看漫画用个人普通账号给家人开专属账号。这样万一哪天某个账号密码泄露损失范围也是可控的。3. cpolar 内网穿透把本地漫画库变成随身服务Teemii 部署好之后接下来就是最关键的外网访问环节。cpolar 在这套方案里的作用前面已经说过了这里直接写安装和配置的完整流程。3.1 cpolar 安装与认证cpolar 支持 Windows、macOS、Linux 三个平台。我家里那台小主机跑的是 Linux所以直接用脚本安装。如果你用的是 NAS 或者云主机流程大同小异核心就是把 cpolar 这个客户端装上然后让它和你的账号绑定。Linux 下安装命令很简单curl -L https://www.cpolar.cn/static/downloads/install-release-cpolar.sh | sudo bash装完后第一件事是检查版本确认装的是新版cpolar version然后需要去 cpolar 官网注册一个账号拿到属于你自己的认证 Token。这个 Token 是为了把本机运行的 cpolar 客户端和你的账号身份绑定后续创建隧道、管理域名都要在这个账号体系下进行。认证命令cpolar authtoken 你的Token这一步不完成后面所有隧道操作都会提示“未认证”。安装完成之后建议先设置开机自启。用 systemd 托管最省心sudo systemctl enable cpolar sudo systemctl start cpolar这样重启小主机之后cpolar 会自动拉起所有已配置的隧道不需要每次手动执行命令。3.2 创建 Web 站点隧道与固定地址cpolar 的隧道可以理解为一条数据通路。你把这条通路的本地地址指向 3000 端口cpolar 就会在边缘节点上生成一个公网入口。创建隧道的命令非常直白cpolar http 3000执行后终端会返回一个临时分配的域名。这个域名形如“xxx.cpolar.cn”用浏览器打开就是你的 Teemii 登录页面。但临时域名有一个很明显的问题——每次重新启动 cpolar或者超过一定时间域名可能变。你辛辛苦苦存的浏览器书签第二天可能就失效了。所以固定域名几乎是刚需。cpolar 的付费套餐里包含固定域名和固定二级子域名。在官网控制台里开通对应套餐后可以获得一个专属的二级域名前缀。在本地配置隧道时把 subdomain 填成那个前缀即可。不过这里要提醒一句如果你只是想先验证方案临时域名也能用只是每次出门前先开一下电脑、看一下当前域名是什么、再告诉家里人这体验就有点崩溃了。我自己是用了固定域名才真正觉得“随身”两个字落实了。另外cpolar 还支持通过配置文件来管理隧道这个比命令行参数要好用得多。在 ~/.cpolar/cpolar.yml 里可以预先定义好隧道名称、本地端口、协议类型、固定子域名tunnels: teemii: proto: http addr: 3000 subdomain: myteemii保存后重启 cpolar 服务隧道就会自动建立。这个方式的优势在于以后不需要记命令服务重启后隧道自动恢复省心。3.3 安全加固访问密码与连接限制把漫画库挂在公网上安全措施一定要跟上。虽然只是个人收藏但你也不想被人拿去当免费公共图书馆用更不想被人扫到一个后台入口。第一道防线是 Teemii 本身的访问密码。之前已经提过关闭匿名访问启用用户认证。这样即使别人知道了你的域名也进不了书屋。第二道防线是 cpolar 的访问控制。cpolar 的隧道支持在配置里设置 Basic Auth相当于在 Teemii 前面再套一层独立的账号密码。这样即使 Teemii 某个版本爆出认证漏洞外网访问者也绕不过这层额外的 HTTP 认证。我最终的配置大概是这样的tunnels: teemii: proto: http addr: 3000 subdomain: myteemii basic_auth: - username: mreader password: 一个足够长的密码为什么要加这层因为我的路由器后面还挂着 NAS 和其他内网设备我不希望 cpolar 成为进入整个内网的跳板。把隧道权限收敛到单端口、加独立认证就算攻击者突破了 Teemii 这一层也至少会被 Basic Auth 拦住一次。第三个有用的配置是 IP 白名单但这个功能一般需要套餐支持。如果你和我一样付费开通了固定域名可以看看控制台里有没有“访问来源限制”的选项。把访问来源限制到自己和家人的 IP 段漫画库就基本处于半私密状态了。还有一个经验想分享不要用默认的弱密码。听起来像废话但很多人对自托管服务的密码管理非常随意。既然这套漫画库已经是公网可达那它就是一个真实的攻击目标。密码长度至少 16 位最好用一个密码管理器生成随机串。4. 手机端体验调优与日常使用心得整个系统跑通之后手机端的使用体验就是最关心的事了。4.1 移动浏览器阅读的设置建议Teemii 的网页端是响应式的手机浏览器直接打开域名界面会自动适配。但有一些浏览器层面的设置会影响阅读体验。我把这些经验整理成一条条强烈建议用主力浏览器把 Teemii 的域名添加到主屏幕。这样点开它就像点开一个原生的漫画 App不会有地址栏在那里碍事。浏览器请求桌面版网站的选项不要开。Teemii 的手机版布局做了专门优化桌面版反而要在屏幕上放大缩小。如果用的是带流量节省模式的浏览器记得把这个域名加入白名单。流量节省模式下图片加载会被压缩漫画画面的细节就糊掉了。锁屏自动旋转的设置要合理。横屏看书的时候最烦的就是一个通知弹出来屏幕方向晃一下阅读位置就丢了。建议竖屏阅读单页模式横屏阅读双页模式看自己习惯来。我自己平时的习惯是通勤路上竖屏看单页在家懒人沙发上横屏看双页。Teemii 的阅读器会记住每本书的进度随时切设备都能接上。4.2 远程管理漫画库的实用技巧很多人以为出门在外就只能“看”其实 Teemii 的管理后台在手机浏览器上也能操作。遇到临时想加一本书的情况我在外面也能用手机上传文件到服务器然后触发一下重新扫描。具体做法是登录管理员账号进入收藏管理选择上传文件。手机端的文件选择器支持从网盘、本地目录导入。实测上传一部 50MB 左右的单行本在家庭 30Mbps 上行带宽下大约十几秒体验可以接受。但我必须说一句老实话——大批量整理漫画还是老老实实在电脑上做。手机远程上传适合单本应急不适合批量操作。批量上传统计进度很费眼而且网络一波动就会失败远不如直接在局域网里复制文件来得痛快。远程管理中最实用的功能其实是“重新扫描目录”。有时候你在电脑上整理完文件忘了在 Teemii 后台触发扫描书架里看不到新书。在外面用手机打开后台点一下重新扫描等两分钟新书就自动出现在书架上。这种碎片化的管理动作手机端完全够用。4.3 流量与速度的实测感受关于速度我直接说实际体感。家庭宽带的上行带宽是这套方案的天花板。我家里用的是 100Mbps 下行、30Mbps 上行的宽带通过 cpolar 免费隧道出门实测加载一页漫画图片正常情况下 2 到 4 秒。如果漫画单页图片超过 5MB会慢一些但翻页本身不受影响因为阅读器有预加载机制。打开一本书的首页时封面图一般会快一些因为 Teemii 生成的缩略图比原始图片小很多。内页加载速度主要看宽带上行。如果家里上行太窄比如只有 10Mbps那外网阅读体验会明显下降图片会有一点点“先模糊后清晰”的感觉。如果实测后确实慢有两个改善方向升级家庭宽带的上行带宽或者在宽带套餐里找有没有提速包。给 cpolar 升级一个更高带宽的套餐。cpolar 付费套餐通常带宽更高节点也更稳定。我自己的经验是免费套餐足够验证方案长期使用还是建议开通付费固定域名套餐。就我个人而言从免费换到付费套餐之后最直观的变化就是出门在外加载稳定了很多不再经常遇到隧道重连的“疙瘩”感。5. 常见问题与排查实录搭建过程中我踩了不少坑整理成问题排查速查表你按着现象查原因基本能解决大部分问题。现象可能原因解决方法能打开首页但登录后白屏Teemii 数据库文件损坏或运行时间太久重启容器若仍复现先备份 config 目录再重装刮削不到封面和简介公共元数据源限流或网络超时错峰刮削分批次操作查看日志确认是网络问题cpolar 临时域名打不开本机 cpolar 服务未启动检查systemctl status cpolar确认隧道在线固定域名访问很慢家庭上行带宽不足检查宽带上行实测速率或者升级 cpolar 套餐手机上传文件中断大文件上传连接不稳定换用电脑局域网批量导入或把大文件拆分压缩包CBR 文件打不开RAR 解析兼容问题尝试先用工具把 CBR 转成 CBZ 再入库重装容器后书架全空配置目录没有持久化映射确认 config 和 library 都映射到宿主机路径5.1 能打开首页但登录后空白这个问题我遇到过一次最后发现是 Teemii 容器运行时间太长内存泄漏导致前端资源加载不完整。重启容器就好了。如果重启后依然白屏那就得考虑是不是容器里 /app/config 目录里的数据库文件出了错。把整个 data/config 目录备份下来然后让 Teemii 重新初始化再把漫画目录重新挂载一遍通常能恢复。切记不要轻易删掉 config 目录除非你确定里面没有重要的阅读进度和收藏数据。我见过有人手一抖直接删了 config重新扫描几万本漫画刮削全部重新来整整折腾了一个周末。5.2 刮削不到封面与简介这个问题的重灾区是“中文漫画”。公共元数据源对中文作品的支持参差不齐很多冷门作品根本查不到条目。我的经验是文件命名越规范刮削命中率越高。把“作品名”尽量写成准确的官方中文名不要加“【完结】”“高品质”之类的标注后缀。整理文件时文件夹命名尽量精炼。如果刮削不到也不要太纠结。Teemii 支持手动编辑元数据打开某一本的编辑页面自己上传封面图、填写简介就行。工作量虽然大但只对极少数冷门作品这样做。5.3 外网访问不稳定或加载慢这个问题我折腾了最久。刚开始在家里测试局域网里打开很快但出门用流量访问时图片加载总是时快时慢。后来发现原因出在家庭宽带的“上行拥塞”——家里电脑正在上传网盘文件时上网带宽被占满隧道自然就慢了。排查思路很简单出门访问慢的时候先问一下家里是不是有人在大批量下载或者上传。如果家里网络一直有持续性的上传任务建议把路由器带宽限速策略打开给 cpolar 所在的小主机单独划分一个保留带宽。另外cpolar 客户端本身运行在主机的资源也值得关注。如果小主机本身 CPU 跑满转发性能也会下降尽量把 Teemii 和 cpolar 都放在资源充足、负载不高的设备上。5.4 资源占用与长期运行的维护Teemii 加上 cpolar实际资源占用比我预想的低。在 2 核 2G 内存的小主机上跑Teemii 容器内存占用大约 400MB 到 600MBcpolar 客户端大约 50MB 到 80MB。这个量级对绝大多数老旧的闲置主机都很友好。长期运行需要关注的只有三点磁盘空间。漫画图片数量大了之后Teemii 生成的缩略图缓存会占用一些空间定期清理旧的缩略图缓存能释放不少容量。Docker 镜像更新。Teemii 官方偶尔发新版本更新的前先看 release notes如果只是小改动可以不用着急等重要功能更新时一起升级。证书和域名有效期。cpolar 的固定域名不需要自己维护 TLS 证书它会自动处理 HTTPS这个省心很多。说实话这套系统搭建完成之后我对“私人数字资产”这件事的看法变了不少。以前总觉得那些漫画文件只是硬盘里躺着的数据现在它们是一间随时能推门进去的小书屋。出门前不用想着“要不要缓存几本路上看”因为每一本都在那里。家里人有自己的账号小朋友的书架里只有我筛选过的东西而我自己有一整个完整的阅读空间。这个项目虽然技术上没有多高深但带来的日常满足感很真实。如果你也在纠结怎么把零散的漫画收藏整理起来照着这套流程走一遍应该能少走不少弯路。