Freedeck快速入门:10分钟在Steam Deck上装好不限速游戏下载神器
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 —— 找游戏、下游戏、装游戏、同步存档,全部在一个插件里完成。🚀