magnetikonline/acestream-server

Docker Ace Stream服务器镜像

这是一个Ace Stream服务器的Docker镜像，基于Debian 8（Jessie）slim系统运行，简化P2P流媒体传输的部署与使用。

镜像概述

本镜像包含：

• 容器化的Ace Stream服务器（版本3.1.49），运行在轻量Debian 8环境中；
• 启动脚本，向主机暴露HTTP API端点以控制服务器；
• Python脚本playstream.py，可指定程序ID启动流传输，并可选启动VLC等播放器。

该镜像解决了Ace Stream在OS X等非原生支持系统上的使用问题，通过单一HTTP端点实现服务器控制与流输出。

核心功能

1. 容器化部署：快速搭建Ace Stream服务器，无需手动配置依赖；
2. HTTP API管理：支持获取服务器版本、启动流传输等操作；
3. 脚本化播放：通过playstream.py一键启动指定流并集成播放器；
4. 性能优化：Linux主机支持tmpfs挂载缓存目录，减少磁盘写入。

使用场景

• 在OS X等非原生系统上播放Ace Stream内容；
• 个人或测试环境中快速部署P2P流媒体服务器；
• 自动化媒体播放工作流，通过脚本批量处理流任务。

配置与使用说明

构建或拉取镜像

• 本地构建：

  sh
  ./build.sh
  

• 从Docker Hub拉取：

  sh
  docker pull magnetikonline/acestream-server:3.1.49_debian_8.11
  

启动服务器

• 常规启动：

  sh
  ./run.sh
  

• Linux主机推荐（tmpfs缓存优化）：

  sh
  ./run-tmpfs.sh
  

服务器启动后可通过http://127.0.0.1:6878访问，示例：

sh
curl http://127.0.0.1:6878/webui/api/service?method=get_version
# {"result":{"code":3014900,"platform":"linux","version":"3.1.49"},"error":null}

播放流示例

使用playstream.py启动指定程序ID的流并打开VLC：

sh
./playstream.py \
  --ace-stream-pid YOUR_PROGRAM_ID \
  --player /usr/bin/vlc \
  --progress

参数说明：

• --ace-stream-pid：必填，流的程序ID；
• --player：流就绪后启动的播放器路径；
• --progress：每2秒输出流统计（对等节点数、传输速率）。

参考资料

• Ace Stream英文维基：[***]
• HTTP API文档：[***]
• playstream.py灵感来源：https://github.com/jonian/acestream-launcher