一、速览：它是什么，能解决什么

入门

zyfun 是一个桌面端视频播放器，支持 Windows、macOS 和 Linux。它本身不提供电影或电视节目，但可以导入别人维护好的资源源。资源源就像一个“内容仓库清单”，zyfun 会把它变成整齐的海报墙或频道列表，点一下就能播。

它适合那些不想在浏览器里装插件、想用一个干净桌面软件看片的人。界面用 Vue3 框架和 TDesign 组件库开发，相当于用预制好的积木搭出好看的界面，所以观感和传统播放器不一样。

如果只想快速用起来，可以直接跳到第二部分安装。

二、安装：各平台下载与前置条件

入门

开始前，请准备一台能联网的电脑，系统可以是 Windows 10/11、macOS 或常见 Linux 发行版。联网用于下载安装包，以及之后加载资源源。电脑配置和日常上网差不多即可，没有特别要求。

前往项目的 GitHub Releases 页面（代码托管平台 GitHub 的下载发布页）下载对应系统的安装包。Windows 用户下载 .exe 文件，macOS 用户下载 .dmg 或 .zip 文件，Linux 用户通常下载 .AppImage 文件。AppImage 是一种免安装的 Linux 软件包格式，正式版直接下载，开发版需要登录 GitHub 账号。

Linux 用户如果使用 AppImage 格式，运行时可能提示缺少 FUSE。FUSE 是一种让 AppImage 能“挂载”并启动的系统功能，相当于给便携软件一块临时运行空间。Ubuntu/Debian 可以执行：

sudo apt-get install libfuse2

安装后，右键属性给 AppImage 文件勾选“允许执行”，再双击即可。Windows 和 macOS 按常规安装流程走完就行。

三、核心用法：导入资源源，开始播放

入门

第一次打开 zyfun，界面可能比较空，因为软件不内置视频内容。你需要找一个可用的资源源，通常是一个链接或本地 JSON 文件（一种常见的数据记录格式）。资源源由第三方提供，不是本项目自带，请通过可靠渠道获取。

在软件内找到“数据管理”或“设置”相关入口，把资源源地址粘贴进去，或导入本地文件。不同版本的按钮位置可能略有不同，可以多在主界面侧边栏找找。

zyfun 主要有影视和直播两种模式。影视模式下，资源会以海报卡片展示，点卡片进详情后再选播放；直播模式则更像电视频道列表，点击频道直接观看。播放内核基于 zyplayer，常见视频流格式都能直接播放。

四、播放操作和历史记录

入门

进入播放页后，底部有常规的播放控制条，可以暂停、拖动进度、切换清晰度或选集。播放器会自动记住观看进度，下次打开同一部片时会从上次位置继续。

左侧或顶部菜单里有“历史”入口，可以看到最近播放过的内容。这个功能类似浏览器的历史记录，方便你接着看，不用重新在资源源里翻找。

五、配置与数据文件位置

进阶 · 推荐细读

zyfun 的配置、数据库、插件和日志都放在用户目录下，清楚这些位置可以在软件打不开时进行备份或清理。不同系统的数据路径如下：

配置文件里可以调整主题（跟随系统、亮色、暗色）、语言（简中、繁中、英文等）和代理。代理支持系统代理、自定义代理和直连。如果网络访问资源源不稳定，可以在这里填写 HTTP（网页传输协议）或 SOCKS5（一种代理协议）代理地址。

修改配置前建议先关闭 zyfun 并备份原文件。配置里的版本号字段要与正在使用的版本一致，否则数据库执行可能报错。

六、踩坑与常见问题

进阶 · 推荐细读

资源源失效：这是最常见的问题，通常与软件本身无关。资源源服务器可能关停或更换地址，建议准备多个备用源并保持更新。

Linux 下 AppImage 无法启动：多数情况是缺少 libfuse2，运行 sudo apt-get install libfuse2 后重试。若仍失败，可以搜索 --appimage-extract 的用法解压后运行，适合有一定基础的用户。

开发版下载要登录 GitHub：开发版是给想要提前体验新功能的人用的，如果不方便登录，使用正式版即可满足日常使用。

迁移到新电脑：把上面表格中对应系统的数据文件夹整个复制到新电脑相同位置，就能保留原来的源、历史和设置。

项目信息

参考链接

• GitHub 仓库

延伸阅读

想继续探索？这些同领域的教程可能也适合你：

• 「server」中文使用教程
• LibreTV 中文教程：1 分钟部署一个属于你自己的免费影视搜索站