K7：为亲友小圈子打造的自托管媒体架

项目定位

K7 是一个面向家人和朋友小圈子的自托管媒体服务器。它希望把电影、电视剧和音乐放回一个由自己掌控的“本地架子”里，而不是依赖外部流媒体目录。项目采用 AGPL-3.0，适合希望自行管理媒体、账户和部署边界的家庭用户、小型社群以及家用实验室使用者。

图片来源：K7。项目公开截图，界面可能随版本变化。

能做什么

K7 的核心媒体类型包括电影、电视剧和音乐。服务器支持本地认证，并可选启用双因素认证或 OIDC；管理员还可以开启受限访客模式。播放方面，项目使用 FFmpeg 和 HLS 进行转码，用于原始文件无法被客户端或网络直接处理的场景。

客户端覆盖 Web、Android 手机与电视、Windows、iOS 和 Mac。项目还提供远程控制、Web 与 Android 的 Chromecast 投放，以及通过 app password 连接 OpenSubsonic 客户端的能力。需要注意的是，README 明确说明 iOS 和 Mac 构建虽然存在，但维护者没有 Apple 硬件进行测试，因此采用前应把这两个平台视为未确认的实际兼容范围，而不是默认可用。

围绕个人使用，K7 提供播放列表、合集、历史、统计、评论、动态播放列表和原生客户端离线下载。动态播放列表会依据流派、年份、播放次数、艺术家等规则重新计算。元数据也可编辑，并能锁定字段，降低后续刷新覆盖手工修改的风险。可选的 AudioMuse AI 集成提供基于文本提示的音乐发现能力，但该服务需要单独自托管并连接，默认关闭。

小圈子协作

K7 的联邦功能可以连接两个 K7 实例，在不复制媒体文件的情况下共享和串流远程媒体及元数据。这对分散存储、由不同朋友维护服务器的场景有吸引力。不过，联邦会带来账户、访问权限、网络连通性和内容边界等额外管理工作，部署者应先明确谁能看到什么、谁负责维护每个实例。

v1.12.0 增加了自定义导航、动态合集、音乐排行榜和独立的导入工具 Docker 镜像。导入工具用于从 Plex、Jellyfin、Spotify 等来源迁移，具体适用范围仍应按项目文档和实际数据验证，不能仅凭功能名称推断迁移结果。

部署前的限制

README 提供 Docker 快速开始流程：复制环境变量示例、设置 PostgreSQL 密码、启动 Compose，然后访问本地 7080 端口完成首次设置。资料没有给出最低 CPU、内存、存储或带宽要求，因此不能据此规划硬件。转码、多人同时播放、离线下载、联邦和媒体扫描的资源消耗也未在提供的来源中量化。

自托管意味着管理员要负责数据库、媒体目录、备份、更新、网络暴露和账户权限。AGPL-3.0 也意味着修改后通过网络提供服务时，需要遵守相应的源码提供义务。项目页面还显示它面向特定维护者需求，贡献不保证合并；这提醒采用者应评估自己的维护能力，而不要把它当作有明确商业支持承诺的平台。

资料来源

• GitHub repository metadata
• Project README
• Official release
• Official project page

资料核对日期：2026-09-18