用户手册

欢迎使用 AniLinkServer！本手册为普通用户提供详细的使用指南，包括安装、配置、媒体管理和播放等全方位的功能说明。请在阅读本文档前，通过【快速开始】先完成服务的基础搭建

快速导航

安装与初始化 - 首次使用的必读指南
媒体库管理 - 添加媒体库、扫描视频文件
动漫浏览与搜索 - 浏览动漫库、搜索功能
视频播放与弹幕 - 播放视频、弹幕功能详解
系统配置 - 站点配置、Dandan App等
故障排查 - 常见问题解决方案

功能概览

核心功能

📚 媒体库管理

添加和管理本地媒体库
自动扫描视频文件
实时文件变更监听
支持多媒体库配置

🎯 番剧自动匹配

集成弹弹play番剧数据库
自动识别视频对应的番剧和剧集
获取番剧详情和封面
修改已匹配的番剧信息

📺 播放功能

HTML5视频播放
HTTP Range支持（可拖拽进度）
集成Artplayer播放器
多种音轨和字幕支持

💬 弹幕功能

实时弹幕显示和缓存
弹幕信息搜索和过滤
支持多种弹幕格式
自定义弹幕显示参数

📺 动漫库

完整动漫库浏览
全文搜索功能
动漫详细信息展示
周更新番时间表

⚙️ 系统管理

系统信息查看
站点配置
Dandan App配置
视频文件管理

系统要求

硬件要求

配置项	最低要求	推荐配置
CPU	2核	4核+
内存	2GB	4GB+
硬盘	10GB（系统）	20GB+（含缓存）
网络	10Mbps	100Mbps+

软件要求

Docker环境（推荐）

Docker 20.10+（或Docker Desktop）
2GB可用内存

非Container环境

Java 17+
PostgreSQL 12+（可选，默认使用H2）

./installation.md)

常见场景

场景1：我有一个包含番剧视频的文件夹

启动AniLinkServer
进入媒体库管理页面
点击添加媒体库，选择你的文件夹
等待自动扫描完成
访问动漫库查看已匹配的番剧

详见媒体库管理

场景2：我想搜索特定番剧

进入动漫库页面
使用顶部搜索框搜索番剧名称
点击番剧卡片查看详情和本地剧集
选择剧集开始播放

详见动漫浏览与搜索

场景3：我要修改某部番剧的信息

进入管理后台 -> 动漫库
搜索目标番剧
点击编辑修改名称、封面等信息
保存修改

详见系统配置

场景4：弹幕功能不工作

检查以下项：

确认视频来源支持弹幕（通常需要匹配的episodeId）
检查系统设置中的弹幕源配置
尝试刷新页面
查看浏览器控制台是否有错误信息

详见故障排查 - 弹幕问题

重要提示

媒体库路径

不应只读 - 系统需要写入权限以更新文件索引
建议独立 - 放在专门的媒体库文件夹，避免混合其他文件
性能考虑 - 使用本地磁盘而非网络存储以获得最佳性能

数据备份

定期备份 - 定期备份 ./anilink/config 和数据库
文件夹 - 如使用H2，还需备份 ./anilink/data 文件夹
配置保留 - 重装系统时保留 config 文件夹以恢复配置

性能优化

禁用未使用功能 - 在管理后台禁用不需要的功能
定期维护 - 定期清理历史数据和缓存
硬件升级 - 处理大型库（>10000个文件）时考虑升级硬件

获取帮助

在线文档 - 详见本手册各章节
GitHub Issues - 提交问题或建议
社区讨论 - 参与讨论

新手获胜秘诀

✅ 从H2开始 - 使用默认H2数据库，不必安装PostgreSQL
✅ 使用Docker - 避免复杂的本地配置
✅ 按步骤操作 - 完整执行安装向导流程
✅ 查看日志 - 遇到问题时查看容器日志 docker logs anilink
✅ 耐心等待 - 首次扫描大型库可能需要数分钟

祝你使用愉快！ 🎉