5 分钟连上 Synology NAS新手入门 Synology API 的完整路线【免费下载链接】synology-apiA Python wrapper around Synology API项目地址: https://gitcode.com/gh_mirrors/sy/synology-api如果你想在 Python 脚本里管理 Synology NAS——列文件、查下载任务、自动备份资料Synology API 是一个可以直接上手的封装库它把 Synology 官方的 REST 接口包成一个个 Python 方法登录、会话、参数拼装都替你处理好了。这篇文章按新手第一次动手的顺序带你从安装、认证到跑通第一条 API 调用最后留一份排错速查表备用。为什么需要它别再手写接口请求了你在 DSM 网页界面上点过的每个按钮背后其实都是一条 webapi 请求。想自己发这些请求你得处理 sid 会话、api、method、version 一堆参数还要自己管 Cookie 和 JSON 解析。Synology API 把这些全部收进了类里你只需要告诉它 IP、端口和账号剩下的交给它。这样写 Synology NAS Python 脚本时精力可以全放在业务逻辑上而不是抠请求细节。第 1 站 环境准备一条命令装好依赖先在终端确认 Python 版本项目需要 Python 3python3 --version然后安装pip3 install synology-api为什么推荐 pip 安装因为 requests、tqdm、cryptography 这些依赖会按项目 setup.py 里的清单自动拉齐省得你手动一个个装。如果内网装不了包也可以从源码安装git clone https://gitcode.com/gh_mirrors/sy/synology-api cd synology-api python3 setup.py install第 2 站 连上你的 NAS实例化即完成认证下面是最小可运行的初始化代码把四个参数换成你自己的from synology_api.filestation import FileStation fs FileStation(192.168.1.10, 5000, admin, 你的密码, secureFalse, dsm_version7, debugTrue)几个容易踩坑的点secure 要和端口对应HTTP 一般是 5000HTTPS 是 5001填错就连不上dsm_version 跟着系统走DSM 7 就填 7它是认证协议版本填错同样认证失败开了两步验证就传 otp_code初始化时把动态验证码传进去即可认证在实例化那一刻就完成了类会自动登录、拿到会话之后所有方法直接调用。同进程里再实例化 DownloadStation 等其他类时会话会被复用不会重复登录在外访问家裡的 NAS可以把 IP 和端口换成quickconnect_id你的QuickConnect ID它会自动走 HTTPS。第 3 站 第一次调用拿到第一份数据连上之后最简单的验证动作是取文件管理器的信息info fs.get_info() print(info[success], info[data][hostname])✅ 看到True和你的主机名恭喜链路已经通了。所有方法的返回都是解析好的字典JSON 转 Dict你可以直接用[success]判断成败再用[data]取业务数据。想继续深入调用 FileStation 接口fs.get_file_list(/volume1)就能列出目录内容downloadstation.DownloadStation里的方法则负责 NAS 下载管理自动化比如查询任务队列、添加下载链接。卡住了先自查三类信号对号入座 跑不通时先别怀疑自己按信号分层排查连接层报错连不上、超时IP 和端口对不对、secure 参数是否和端口协议一致、路由器防火墙是否放行认证层报错登录失败用户名密码、账号是否被禁用、是否漏传 otp_code接口层报错success 为 False 或带错误码确认 dsm_version 正确、NAS 上装了对应套件用 DownloadStation 就得先装 Download Station错误码含义可以在项目的 synology_api/error_codes.py 里查。平时把debugTrue打开控制台日志会告诉你请求走到了哪一步定位快很多。常见报错速查表现象先查哪里连接超时 / ConnectionErrorIP、端口、secure 是否匹配5000/HTTP5001/HTTPS认证失败用户名密码、两步验证otp_code、账号权限success: False 带错误码dsm_version、NAS 是否装了对应套件、错误码含义证书验证报错cert_verifyFalse 或为自签证书配置信任到这里你已经能连上 NAS 并拿到真实数据了。下一步建议从get_file_list开始写一个「每天自动备份某个文件夹」的小脚本再顺手把 DownloadStation 的任务查询接进去——有了这两块NAS 下载管理自动化就有雏形了更多参数说明可以继续翻项目文档里的 getting-started 章节深入阅读。【免费下载链接】synology-apiA Python wrapper around Synology API项目地址: https://gitcode.com/gh_mirrors/sy/synology-api创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考