{"id":13801044,"url":"https://github.com/idootop/feiyu-player","last_synced_at":"2025-05-16T06:04:09.555Z","repository":{"id":65808338,"uuid":"597604128","full_name":"idootop/feiyu-player","owner":"idootop","description":"🐟 一个漂亮得不像实力派的跨平台视频播放器 ","archived":false,"fork":false,"pushed_at":"2024-12-07T16:39:46.000Z","size":10068,"stargazers_count":399,"open_issues_count":1,"forks_count":36,"subscribers_count":3,"default_branch":"main","last_synced_at":"2025-04-08T15:14:50.287Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://feiyu-player.xbox.work","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/idootop.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2023-02-05T03:20:42.000Z","updated_at":"2025-03-30T14:25:08.000Z","dependencies_parsed_at":"2023-04-25T09:31:32.483Z","dependency_job_id":"f8231152-131e-457b-8c1e-dc272319d262","html_url":"https://github.com/idootop/feiyu-player","commit_stats":null,"previous_names":[],"tags_count":7,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/idootop%2Ffeiyu-player","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/idootop%2Ffeiyu-player/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/idootop%2Ffeiyu-player/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/idootop%2Ffeiyu-player/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/idootop","download_url":"https://codeload.github.com/idootop/feiyu-player/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254478160,"owners_count":22077675,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-08-04T00:01:18.986Z","updated_at":"2025-05-16T06:04:09.500Z","avatar_url":"https://github.com/idootop.png","language":"TypeScript","funding_links":[],"categories":["TypeScript","Applications"],"sub_categories":["Audio \u0026 Video"],"readme":"# 🐟 飞鱼\n\n一个漂亮得不像实力派的跨平台视频播放器 ✨\n\n![](https://github.com/idootop/feiyu-player/raw/main/screenshots/play.webp)\n\n## ✨ 特性\n\n- **🐳 海量资源，随心搜索**: 支持多种视频源，聚合搜索，看你想看。\n- **🦀 一键订阅，自由分享**: 一键订阅视频源，从此找资源不求人。\n- **🦋 界面极简，超高颜值**: 颜值即正义，给你极致观影体验。\n- **🦄 体积小巧，快如闪电**: 极至精简，安装包不足 10 MB。\n- **🐟 随时随地，想看就看**: 网页、Windows、macOS、Linux 全平台支持。\n\n## ⚡️ 快速开始\n\n推荐下载安装包后使用，或者直接访问[官网](https://feiyu-player.xbox.work)，在线体验网页版演示。\n\n| 操作系统 | 下载链接                                                                                                                |\n| -------- | ----------------------------------------------------------------------------------------------------------------------- |\n| Windows  | [feiyu_windows_x86_64.exe](https://github.com/idootop/feiyu-player/releases/download/latest/feiyu_windows_x86_64.exe)   |\n| macOS    | [feiyu_macos_universal.dmg](https://github.com/idootop/feiyu-player/releases/download/latest/feiyu_macos_universal.dmg) |\n| Linux    | [feiyu_linux_x86_64.deb](https://github.com/idootop/feiyu-player/releases/download/latest/feiyu_linux_x86_64.deb)       |\n\n\u003e 首次安装后，你需要配置订阅才能正常使用。有关订阅的格式和参数说明，请参考下面的 [📖 管理订阅](https://github.com/idootop/feiyu-player?tab=readme-ov-file#-%E7%AE%A1%E7%90%86%E8%AE%A2%E9%98%85) 部分。\n\n## 🐳 Docker\n\n[![Docker Image Version](https://img.shields.io/docker/v/idootop/feiyu?color=%23086DCD\u0026label=docker%20image)](https://hub.docker.com/r/idootop/feiyu)\n\n如果你想要将飞鱼部署到自己的网站，或者在本地 NAS 上运行，可以使用 Docker 镜像一键部署。\n\n```shell\ndocker run -d -p 4399:3000 idootop/feiyu:latest\n```\n\n启动成功后，即可通过 [http://localhost:4399](http://localhost:4399) 访问飞鱼。\n\n如需自定义网站内置的默认配置，可以参考 [feiyu.example.json](https://github.com/idootop/feiyu-player/blob/main/feiyu.example.json) 模板，在本地创建 `feiyu.json` 配置文件，并按如下方式挂载启动:\n\n```shell\ndocker run -d -p 4399:3000 -v $(pwd)/feiyu.json:/app/feiyu.json idootop/feiyu:latest\n```\n\n## 📖 管理订阅\n\n为了更灵活的管理视频源等配置，飞鱼支持通过订阅来分享和导入配置文件。\n\n你可以参考 [feiyu.example.json](https://github.com/idootop/feiyu-player/blob/main/feiyu.example.json) 文件，然后根据下面的参数说明配置自己的订阅。\n\n### 视频源 (videoSources)\n\n视频源相当于飞鱼播放器的\"光盘\"，没有配置视频源，飞鱼将无法搜索和播放任何内容。\n\n作为一款通用播放器，**飞鱼自身没有提供任何影视资源**，用户需要自行添加符合规范的视频源。\n\n飞鱼支持集成 [苹果 CMS](https://magicblack.github.io/)、[飞飞 CMS](https://www.feifeicms.org/) 等格式规范的视频源。如果你不了解这些格式，可以自行搜索了解更多详情。\n\n```json\n// 视频源参考配置格式\n{\n  \"videoSources\": [\n    {\n      \"key\": \"视频源1\",\n      \"api\": \"https://api1.example.com/api.php/provide/vod/at/xml\"\n    },\n    {\n      \"key\": \"视频源2\",\n      \"api\": \"https://api2.example.com/api.php/provide/vod/at/xml\"\n    }\n  ]\n}\n```\n\n### 热门影视 (hotMovies)\n\n你可以通过静态/动态配置两种方式，自定义首页显示的热门影视列表。\n\n#### 静态配置\n\n```json\n{\n  \"hotMovies\": [\n    {\n      \"id\": \"26302614\",\n      \"isNew\": false,\n      \"title\": \"请回答1988\",\n      \"cover\": \"https://img9.doubanio.com/view/photo/s_ratio_poster/public/p2272563445.jpg\",\n      \"rate\": \"9.7\"\n    },\n    {\n      \"id\": \"25848328\",\n      \"isNew\": false,\n      \"title\": \"最后生还者 第一季\",\n      \"cover\": \"https://img9.doubanio.com/view/photo/s_ratio_poster/public/p2884221114.jpg\",\n      \"rate\": \"9.1\"\n    }\n    // ...\n  ]\n}\n```\n\n#### 动态配置\n\n你也可以配置一个返回热门影视数据的远程 JSON 接口地址，如:\n\n```json\n{\n  \"hotMovies\": \"http://example.com/hotMovies.json\"\n}\n```\n\n该接口需返回一个符合上述静态配置格式的热门影视数组\n\n```json\n// http://example.com/hotMovies.json\n[\n  {\n    \"id\": \"26302614\",\n    \"isNew\": false,\n    \"title\": \"请回答1988\",\n    \"cover\": \"https://img9.doubanio.com/view/photo/s_ratio_poster/public/p2272563445.jpg\",\n    \"rate\": \"9.7\"\n  },\n  {\n    \"id\": \"25848328\",\n    \"isNew\": false,\n    \"title\": \"最后生还者 第一季\",\n    \"cover\": \"https://img9.doubanio.com/view/photo/s_ratio_poster/public/p2884221114.jpg\",\n    \"rate\": \"9.1\"\n  }\n  // ...\n]\n```\n\n### 请求代理 (proxy)\n\n有些视频源可能无法直接在网页端使用，这是由于浏览器的同源策略限制。\n\n为解决跨域问题，飞鱼提供了一个专用的请求代理服务，具体使用方法请查看飞鱼 Proxy [使用文档](https://github.com/idootop/feiyu-player/blob/main/packages/feiyu-proxy/README.md)。\n\n\u003e 注意: 此代理服务并非常规的 http_proxy，而是使用飞鱼私有的代理协议，不兼容其他代理服务。\n\n## 🐟 关于飞鱼\n\n飞鱼是一款跨平台的在线视频播放器。它最初基于 [Flutter](https://flutter.dev/) 框架开发，支持 iOS 和 Android 移动设备。本次开源的飞鱼项目，是在飞鱼 [Flutter 版](https://github.com/idootop/feiyu_flutter) 的基础上，进一步适配了网页端和桌面端，让人人都可以随时随地自由观影。\n\n如果你对飞鱼有任何问题或建议，请提 [issue](https://github.com/idootop/feiyu-player/issues)。\n\n**Enjoy! ;)**\n\n## 🚨 免责声明\n\n1. 本项目(飞鱼)是一个开源的视频播放器软件，仅供个人合法地点播、学习和研究使用，严禁将其用于任何商业、违法或不当用途，否则由此产生的一切后果由用户自行承担。\n2. 本软件仅作为一个通用播放器使用，不针对任何特定内容提供源，用户应自行判断所播放内容的合法性并承担相应责任，开发者对用户播放的任何内容不承担任何责任。\n3. 用户在使用本软件时，必须完全遵守所在地区的法律法规，严禁将本软件用于任何非法用途，如传播违禁信息、侵犯他人知识版权、破坏网络安全等，否则由此产生的一切后果由用户自行承担。\n4. 用户使用本软件所产生的任何风险或损失(包括但不限于:系统故障、隐私泄露等)，开发者概不负责。用户应明确认知上述风险并自行防范。\n5. 未尽事宜，均依照用户所在地区相关法律法规的规定执行。如本声明与当地法律法规存在冲突，应以法律法规为准。\n6. 用户使用本软件即视为已阅读并同意本声明全部内容。开发者保留随时修订本声明的权利。本声明的最终解释权归本项目开发者所有。\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fidootop%2Ffeiyu-player","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fidootop%2Ffeiyu-player","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fidootop%2Ffeiyu-player/lists"}