mirror of
https://github.com/truewhile/MeBox.git
synced 2026-10-02 04:16:38 +08:00
feat: add licensing and access controls
This commit is contained in:
ShukeBta
@@ -53,6 +53,13 @@ MediaStationGo 采用完全开源路线，核心媒体库、刮削、播放、
|
||||
|
||||
> 说明：GPL-3.0 是自由软件许可证，其正式授权范围以仓库 [LICENSE](LICENSE) 文件为准；上方「非商用承诺」表达项目维护者的使用边界与商业合作要求。如需商业合作、企业部署或二次发行，请先联系作者获得额外授权。
|
||||
|
||||
### 源码开放与 Docker 部署边界
|
||||
|
||||
- 当前公开仓库继续以 `GPL-3.0` 作为基础许可证；如果代码包含 GPL 派生实现，不能通过“只发布 Docker 镜像”规避对应源码提供义务。
|
||||
- 可以把官方部署策略收敛为 **Docker-first / Docker-only support**：即项目只承诺维护 Docker Compose、GHCR 镜像和容器部署文档，裸机运行与二进制包可作为社区自助能力。
|
||||
- 若未来需要部分闭源，建议将闭源能力拆成独立插件、独立服务或私有模块，并确保该部分为作者自有或兼容许可证的干净实现；GPL 覆盖代码仍应按 GPL 公开。
|
||||
- README 中的非商用声明是维护者的使用边界与商业授权要求；正式代码授权仍以 [LICENSE](LICENSE) 为准。
|
||||
|
||||
---
|
||||
|
||||
## 🚀 在线演示
|
||||
@@ -231,7 +238,7 @@ mkdir -p data cache media downloads
|
||||
```bash
|
||||
cat > .env <<'EOF'
|
||||
# 固定版本；需要升级时改成新的 MediaStationGo-vX.Y.Z 后执行 docker compose pull && docker compose up -d
|
||||
MEDIASTATION_IMAGE_TAG=MediaStationGo-v0.0.11
|
||||
MEDIASTATION_IMAGE_TAG=MediaStationGo-v0.0.15
|
||||
MEDIASTATION_HTTP_PORT=18080
|
||||
|
||||
# 程序数据和缓存建议放在 MediaStationGo 部署目录下，便于备份和迁移。
|
||||
@@ -300,7 +307,7 @@ vim docker-compose.yml
|
||||
#
|
||||
# 镜像版本：
|
||||
# 默认拉取 latest；如需固定版本，创建 .env 并写入：
|
||||
# MEDIASTATION_IMAGE_TAG=MediaStationGo-v0.0.11
|
||||
# MEDIASTATION_IMAGE_TAG=MediaStationGo-v0.0.15
|
||||
#
|
||||
# 路径映射总览：
|
||||
# /data 程序数据目录。保存 SQLite 数据库、JWT secret、系统配置等，必须持久化。
|
||||
@@ -501,7 +508,7 @@ docker compose up -d
|
||||
|
||||
```bash
|
||||
cat > .env <<'EOF'
|
||||
MEDIASTATION_IMAGE_TAG=MediaStationGo-v0.0.11
|
||||
MEDIASTATION_IMAGE_TAG=MediaStationGo-v0.0.15
|
||||
MEDIASTATION_HTTP_PORT=18080
|
||||
MEDIASTATION_DATA_DIR=./data
|
||||
MEDIASTATION_CACHE_DIR=./cache
|
||||
@@ -764,26 +771,26 @@ cd MediaStationGo
|
||||
|
||||
| 平台 | 包名示例 |
|
||||
| --- | --- |
|
||||
| Linux x86_64 | `MediaStationGo-v0.0.11-linux-amd64.tar.gz` |
|
||||
| Linux ARM64 | `MediaStationGo-v0.0.11-linux-arm64.tar.gz` |
|
||||
| Windows x86_64 | `MediaStationGo-v0.0.11-windows-amd64.zip` |
|
||||
| macOS Intel | `MediaStationGo-v0.0.11-darwin-amd64.tar.gz` |
|
||||
| macOS Apple Silicon | `MediaStationGo-v0.0.11-darwin-arm64.tar.gz` |
|
||||
| Linux x86_64 | `MediaStationGo-v0.0.15-linux-amd64.tar.gz` |
|
||||
| Linux ARM64 | `MediaStationGo-v0.0.15-linux-arm64.tar.gz` |
|
||||
| Windows x86_64 | `MediaStationGo-v0.0.15-windows-amd64.zip` |
|
||||
| macOS Intel | `MediaStationGo-v0.0.15-darwin-amd64.tar.gz` |
|
||||
| macOS Apple Silicon | `MediaStationGo-v0.0.15-darwin-arm64.tar.gz` |
|
||||
|
||||
部署步骤：
|
||||
|
||||
```bash
|
||||
# Linux 示例
|
||||
tar -xzf MediaStationGo-v0.0.11-linux-amd64.tar.gz
|
||||
cd MediaStationGo-v0.0.11-linux-amd64
|
||||
tar -xzf MediaStationGo-v0.0.15-linux-amd64.tar.gz
|
||||
cd MediaStationGo-v0.0.15-linux-amd64
|
||||
MEDIASTATION_APP_PORT=18080 ./mediastation-go
|
||||
```
|
||||
|
||||
Windows：
|
||||
|
||||
```powershell
|
||||
Expand-Archive .\MediaStationGo-v0.0.11-windows-amd64.zip
|
||||
cd .\MediaStationGo-v0.0.11-windows-amd64
|
||||
Expand-Archive .\MediaStationGo-v0.0.15-windows-amd64.zip
|
||||
cd .\MediaStationGo-v0.0.15-windows-amd64
|
||||
$env:MEDIASTATION_APP_PORT = "18080"
|
||||
.\mediastation-go.exe
|
||||
```
|
||||
@@ -901,6 +908,47 @@ MediaStationGo/
|
||||
|
||||
---
|
||||
|
||||
## 👥 用户与权限策略
|
||||
|
||||
- 默认管理员由系统首次启动创建，默认账号为 `admin / admin123`；该默认管理员可以改用户名，但不能删除，也不能降级，始终拥有最高权限。
|
||||
- 开源版默认最多允许 20 个用户，避免家庭 NAS 或公开测试环境被滥用；绑定私有授权服务后可按授权策略提升用户额度。
|
||||
- 管理后台新增用户默认为“观看用户”：允许登录 Web 与 Emby 兼容客户端、浏览媒体库、播放媒体、使用外部播放器、收藏与记录观看历史。
|
||||
- 普通观看用户默认不能扫描媒体库、重新刮削、删除媒体、探测媒体轨、写出 NFO、管理文件、管理 STRM、管理下载器、创建下载任务或订阅下载。
|
||||
- 由于视频流播放本身需要向客户端传输媒体数据，系统可以禁止“下载任务”和管理型下载入口，但无法从协议层完全阻止外部播放器或浏览器保存已授权播放的数据流。
|
||||
|
||||
---
|
||||
|
||||
## 🔐 私有授权服务
|
||||
|
||||
MediaStationGo 已预留并接入私有独立的 `MediaStationLicenseServer`：
|
||||
|
||||
- 授权服务器：`ShukeBta/MediaStationLicenseServer`，本地备份路径示例为 `C:\Users\Administrator\WorkBuddy\license_server_backup`。
|
||||
- 主项目后端提供 `/api/license/activate`、`/api/license/status`、`/api/license/heartbeat`，由服务端代理调用 License Server，不在浏览器暴露 HMAC 密钥。
|
||||
- License Server 公共接口使用 `/api/v1/activate`、`/api/v1/status/:fingerprint`、`/api/v1/heartbeat`。
|
||||
- 在「系统设置 → 授权服务」填写 `license.server_url` 与 `license.hmac_secret`，然后在「授权许可」页面绑定授权码。
|
||||
- 未绑定或授权失效时保持开源版能力；授权有效时当前实现将用户额度提升到授权版额度。
|
||||
|
||||
环境变量示例：
|
||||
|
||||
```bash
|
||||
MEDIASTATION_LICENSE_SERVER_URL=http://127.0.0.1:8001
|
||||
MEDIASTATION_LICENSE_HMAC_SECRET=与 License Server 的 LICENSE_HMAC_SECRET 一致
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🎞️ FFmpeg / ffprobe 按需运行
|
||||
|
||||
MediaStationGo 不会把 `ffmpeg` 或 `ffprobe` 作为常驻守护进程启动。它们只在以下场景被临时调用：
|
||||
|
||||
- 扫描或手动探测媒体轨时调用 `ffprobe`。
|
||||
- 浏览器无法直放、需要 HLS 转码时调用 `ffmpeg`。
|
||||
- 管理后台手动检测工具状态或手动安装工具时短暂调用版本检测/安装逻辑。
|
||||
|
||||
播放停止、转码任务取消或服务退出时，后台会结束对应转码任务。空闲状态下如果没有扫描、探测或转码，`ffmpeg/ffprobe` 不应持续占用 CPU。
|
||||
|
||||
---
|
||||
|
||||
## 🔍 刮削与元数据策略
|
||||
|
||||
MediaStationGo 的刮削顺序尽量避免重复请求和错误覆盖：
|
||||
|
||||
Reference in New Issue
Block a user