Homehost Docker部署教程：3步实现跨平台媒体服务器搭建

【免费下载链接】homehost self-hosted, Netflix-like app made for streaming 项目地址: https://gitcode.com/gh_mirrors/ho/homehost

Homehost是一款开源的自托管媒体服务器应用，让你轻松搭建属于自己的Netflix-like流媒体平台，支持电影、音乐和电视节目的一站式管理与播放。通过Docker容器化部署，你可以在任何支持Docker的设备上快速搭建个人媒体中心，享受私人定制的观影听音乐体验。

准备工作：部署前的环境要求

在开始部署Homehost媒体服务器前，请确保你的系统满足以下条件：

• 已安装Docker和Docker Compose
• 至少2GB内存（推荐4GB以上）
• 足够的存储空间存放媒体文件（根据你的收藏量决定）
• 稳定的网络连接

第一步：获取项目代码与配置文件

首先需要将Homehost项目代码克隆到本地：

git clone https://gitcode.com/gh_mirrors/ho/homehost
cd homehost

进入项目目录后，需要创建并配置环境变量文件。复制示例环境变量文件并进行必要修改：

cp packages/server/.env.example packages/server/.env

编辑.env文件，设置媒体文件路径和API密钥：

• MOVIES_PATH：电影文件存放目录
• TV_PATH：电视节目存放目录
• MUSIC_PATH：音乐文件存放目录
• TMDB_KEY：可选，用于获取电影元数据
• SPOTIFY_CLIENT_ID和SPOTIFY_CLIENT_SECRET：可选，用于音乐功能

第二步：配置Docker Compose文件

Homehost提供了现成的docker-compose.yml配置文件，定义了server和client两个服务：

• server服务：运行后端API，监听5000端口
• client服务：运行前端Web界面，监听3000端口，依赖于server服务

你可以根据需要调整端口映射和 volumes 配置，确保媒体文件路径正确映射到容器中。

第三步：启动Homehost媒体服务器

一切准备就绪后，使用以下命令启动服务：

docker-compose up -d

首次启动时，Docker会自动构建镜像并下载所需依赖，这个过程可能需要几分钟时间。启动成功后，你可以通过浏览器访问http://localhost:3000打开Homehost界面。

Homehost电影流媒体界面展示，支持分类浏览和详情查看

体验Homehost强大功能

Homehost提供了丰富的媒体管理和播放功能：

电影与电视节目管理

系统会自动扫描并整理你的媒体文件，生成精美的海报墙和详细信息。你可以按类别、年份、评分等多维度筛选内容。

电视节目管理界面，支持季集浏览和播放历史记录

音乐流媒体功能

除了视频内容，Homehost还提供完整的音乐管理功能，支持专辑浏览、歌手分类和播放列表创建。

音乐模块展示最近添加的歌曲、最新专辑和热门歌手

常见问题解决

如果遇到服务无法启动的问题，可以通过以下命令查看日志：

docker-compose logs -f

确保媒体文件路径权限正确，容器需要有读取媒体文件的权限。如需停止服务，可以使用：

docker-compose down

通过以上三个简单步骤，你已经成功搭建了自己的Homehost媒体服务器。现在可以开始导入你的媒体收藏，享受私人定制的流媒体体验了！

【免费下载链接】homehost self-hosted, Netflix-like app made for streaming 项目地址: https://gitcode.com/gh_mirrors/ho/homehost