> 来源：https://mac-cms.com/cms/cms-connect
> 简介：把自建的 MacCMS（苹果CMS）V10 站点配成空壳影视的影视数据源，详解接口地址、from 优化、字段配置、CORS 跨域与部署托管。自己的资源，电视手机都能看。
> 更新：2026-11-02

# MacCMS对接空壳影视

将自建的MacCMS站点配置为空壳影视的数据源，实现自有资源的影视点播功能。

## 前提条件

- 已安装MacCMS V10（[安装教程](/cms/index)）
- 已完成数据采集（[采集教程](/cms/cms-collect)）
- 空壳影视App已安装

## 获取接口地址

MacCMS的API接口地址为：

```
https://你的域名/api.php/provide/vod/
```

例如：`https://www.example.com/api.php/provide/vod/`

::: tip 测试接口
将接口地址复制到浏览器中访问，如果返回JSON数据则说明接口正常。
:::

::: tip 注意
资源站的接口类型需选择 **MacCMS V10** 或 **苹果V10**  
一般MacCMS首页默认就是此格式。
:::

## 获取播放源名称

访问接口地址后，在返回的JSON数据中找到 `vod_play_from` 字段：

```json
"vod_play_from":"m3u8,iframe"
```

该字段包含所有播放源名称，多个播放源以逗号分隔。

## 优化接口地址

为了减少返回数据量、提高加载速度，可以通过 `from` 参数指定播放源：

```
原来：https://www.example.com/api.php/provide/vod/
优化：https://www.example.com/api.php/provide/vod/from/m3u8/
```

将 `vod_play_from` 的值加到URL末尾，APP只返回该播放源的数据。

## 完整配置示例

```json
{
  "privateKey": "404",
  
  "tvSources": [
    {
      "name": "IPTV",
      "m3uUrl": "https://example.com/tv.m3u",
      "block": false
    }
  ],
  
  "sources": [
    {
      "name": "我的MacCMS",
      "url": "https://www.example.com/api.php/provide/vod/from/m3u8/",
      
      "playerName": {
        "m3u8": "默认"
      },
      
      "blockTypeName": [
        "伦理片",
        "韩国伦理",
        "港台三级",
        "两性课堂",
        "写真热舞"
      ],
      
      "blockAdsRule": [],
      
      "desc": "自建MacCMS资源站"
    }
  ]
}
```

## 字段详细说明

### privateKey（隐私码）

```json
"privateKey": "404"
```

隐私码用于控制非常规资源的访问权限。输入隐私码后才能查看被屏蔽的分类。

### sources（影视点播源）

```json
"sources": [
  {
    "name": "源名称",
    "url": "接口地址",
    "playerName": {},
    "blockTypeName": [],
    "blockAdsRule": [],
    "typeConfig": {},
    "desc": "描述"
  }
]
```

| 字段 | 必填 | 说明 |
|------|------|------|
| name | 是 | 显示在APP中的源名称 |
| url | 是 | MacCMS接口地址 |
| playerName | 否 | 播放器别名配置 |
| blockTypeName | 否 | 需屏蔽的分类名称 |
| blockAdsRule | 否 | 广告过滤正则规则 |
| typeConfig | 否 | 一级分类转二级分类 |
| desc | 否 | 源描述信息 |

### playerName（播放器别名）

```json
"playerName": {
  "m3u8": "默认",
  "iframe": "备用"
}
```

`vod_play_from` 的值与显示别名的映射，用于在APP中显示更友好的名称。

### blockTypeName（屏蔽分类）

```json
"blockTypeName": [
  "伦理片",
  "韩国伦理",
  "港台三级",
  "新闻资讯"
]
```

需要屏蔽的分类名称，对应数据库中 `type_name` 字段的值。输入隐私码后，被屏蔽的分类会显示出来。

::: tip 提示
建议将非常规分类放入屏蔽列表，默认隐藏，需要时通过隐私码访问。
:::

### typeConfig（分类配置）

```json
"typeConfig": {
  "电影": [
    "动作片",
    "喜剧片",
    "爱情片",
    "科幻片",
    "恐怖片",
    "剧情片",
    "纪录片",
    "战争片",
    "动画片"
  ],
  "电视剧": [
    "国产剧",
    "欧美剧",
    "韩剧",
    "日剧",
    "港剧",
    "台剧",
    "泰剧"
  ],
  "综艺": [
    "大陆综艺",
    "日韩综艺",
    "港台综艺",
    "欧美综艺"
  ],
  "动漫": [
    "国产动漫",
    "日韩动漫",
    "欧美动漫"
  ]
}
```

用于一级分类转二级分类。如果你的MacCMS是一级分类（如快车资源站），需要此配置将分类重新组织。

### desc（源描述）

```json
"desc": "自建MacCMS资源站，数据更新及时"
```

显示在设置界面源列表下方的描述文字。

## 部署配置文件

### 方法一：部署到服务器

1. 将JSON配置保存为 `config.json` 文件
2. 上传到服务器（支持HTTPS）
3. 获取文件访问链接
4. 在空壳影视中配置该链接

### 方法二：使用Github托管

1. 在Github创建仓库
2. 上传 `config.json` 文件
3. 使用CDN加速访问（如 ghproxy.com）

配置地址示例：
```
https://ghp.ci/https://raw.githubusercontent.com/用户名/仓库名/main/config.json
```

## 注意事项

- 确保 MacCMS 服务器支持跨域访问（CORS），否则 App 可能取不到数据，配法见[部署排障](/cms/cms-troubleshooting#cors-跨域取不到数据)
- 建议使用 HTTPS 协议
- 接口响应速度影响 App 加载体验
- 所有符号需使用英文半角符号