Freedeck快速入门:10分钟在Steam Deck上装好不限速游戏下载神器

原创2026-11-04 12:26:451,737 阅读

Freedeck快速入门:10分钟在Steam Deck上装好不限速游戏下载神器

Freedeck 是一款专为 Steam Deck 掌机打造的开源游戏管理插件,集不限速游戏下载、游戏库检索、跨设备云存档同步与一键安装于一体。本文带你用 10 分钟在 SteamOS 上完成安装,并跑通"登录 → 搜索 → 下载 → 安装"的完整流程。🎮

一、Freedeck 是什么?

Freedeck 以 Decky Loader 插件的形式运行在 SteamOS 上,核心能力包括:

  • ⚡ 不限速游戏下载:基于 aria2 下载引擎(见 py_modules/aria2_manager.py),多线程拉取资源
  • 📚 游戏库检索:内置数千款游戏目录(默认目录文件 gamebox_all_links_20260221_234730.csv 收录约 2800 条资源),支持按名称搜索
  • ☁️ 云存档同步:将本地存档打包上传到云端,换机后可一键恢复
  • 🚀 一键安装运行:自动解压 7z/zip 等压缩包,并写入 Steam 快捷方式,直接在 Steam 库里启动

插件入口在 main.py,业务编排逻辑集中在 py_modules/tianyi_service.py。

二、安装前准备

条件 说明
Steam Deck 需可正常进入桌面模式(长按电源键 → 切换至桌面)
SteamOS 当前稳定版即可
Decky Loader Steam Deck 插件加载器,Freedeck 依赖它运行
存储空间 建议剩余 ≥ 50GB,游戏解压后体积不小

三、10分钟安装步骤

第 1 步:进入桌面模式

长按 Steam Deck 电源键,选择「切换至桌面」。

第 2 步:安装 Decky Loader

在桌面浏览器中按 Decky Loader 官方指引完成安装(安装后会自动启动加载器服务)。

第 3 步:安装 Freedeck 插件

打开 Decky Loader 管理页面,在插件商店中搜索 Freedeck 安装;也可以从发布页下载 .deck 插件包,在 Decky 页面中拖拽上传。插件元信息定义在 plugin.json。

第 4 步:重启插件加载器生效

安装完成后按提示重启 Decky Loader。进入 Decky 面板应能看到 Freedeck 卡片,显示登录状态、下载任务与已安装游戏列表。

四、首次使用:登录并下载第一份游戏

1. 打开本地游戏库页面

插件会在 127.0.0.1:59271 启动一个本地网页服务(见 py_modules/server_manager.py)。在 Decky 面板点击游戏库入口,即可打开内置的 Vue 搜索页面(页面源码:defaults/tianyi_library_ui/index.html)。

2. 登录天翼账号

首次使用会跳转到登录桥接页面(defaults/tianyi_library_ui/login_bridge.html),按提示完成扫码或 Cookie 登录即可,登录态会自动缓存,无需反复登录。

3. 搜索并下载

在搜索框输入游戏名称,点击游戏卡片确认安装信息(会显示所需空间、ProtonDB 兼容评级),确认后插件自动执行"下载 → 解压 → 写入 Steam 快捷方式"全流程。Steam 快捷方式写入逻辑见 py_modules/steam_shortcuts.py。

4. 在 Steam 中启动

安装完成后回到 Steam 库,游戏图标会出现,点击即可游玩。插件还会自动统计每款游戏的游玩时长。

五、下载设置与目录说明

  • 下载目录:默认 ~/Downloads,可在插件设置中修改(配置项定义见 py_modules/config.py)
  • 任务保留:任务记录默认保留 7 天
  • 本地服务:仅监听本机回环地址,局域网不可访问,安全性较好
  • 运行日志:输出到 /tmp/freedeck.log,排查下载失败时可直接查看

六、进阶:获取源码与关键目录

想深入定制(比如替换游戏目录 CSV),可以克隆仓库:

git clone https://gitcode.com/gh_mirrors/fre/Freedeck

关键路径速查:

模块 路径 作用
插件入口 main.py Decky 插件生命周期
下载业务编排 py_modules/tianyi_service.py 登录态、下载、云存档串联
游戏目录 py_modules/game_catalog.py 读取 CSV、提供搜索
本地网页服务 py_modules/server_manager.py 端口 59271 的 HTTP 路由
游戏目录数据 defaults/tianyi_catalog/gamebox_all_links_20260221_234730.csv 约 2800 条游戏资源

⚠️ 提示:本软件仅限研发测试,禁止商业获利;资源源自互联网,请在使用后 24 小时内删除。

七、常见问题 FAQ

Q1:Decky 面板显示"本地网页未就绪"? 插件会自动启动本地服务,稍等几秒刷新即可;若仍报错,检查端口 59271 是否被其他程序占用。

Q2:登录后提示"登录态已失效"? Cookie 过期属于正常现象,重新打开登录桥接页面完成一次登录即可。

Q3:下载失败或速度异常? 优先检查网络环境,并查看 /tmp/freedeck.log 中的错误信息;aria2 引擎默认多线程下载,大文件速度会明显优于普通浏览器。

Q4:如何卸载已安装的游戏? 在插件面板中选择已安装游戏,可卸载并删除本地文件,同时移除 Steam 快捷方式。

按照以上步骤,你现在已经拥有了一台"下载自由"的 Steam Deck —— 找游戏、下游戏、装游戏、同步存档,全部在一个插件里完成。🚀

登录后查看全文
Freedeck