Sunshine 忘记 Web UI 用户名和密码时如何用 --creds 参数重置【免费下载链接】SunshineSelf-hosted game stream host for Moonlight.项目地址: https://gitcode.com/GitHub_Trending/su/SunshineSunshine 的 Web UI 默认通过https://localhost:47990访问可将localhost替换为主机的内网 IP首次启动时会要求创建登录用的用户名和密码官方文档在 getting started 中专门用 CAUTION 提醒要记牢这组凭据——一旦忘记就只能通过命令行重新设置。Sunshine 为此提供了--creds参数。它的官方帮助文本是--creds username password | set user credentials for the Web manager见 src/logging.cpp 中的print_help。执行后entry_handler.cpp 中的creds处理函数会调用http::save_user_creds()把新的用户名和密码写入凭据文件。本文只覆盖这一件事在忘记了 Web UI 登录信息的情况下用--creds重置凭据并确认能重新登录。准备确定安装方式并准备好新凭据troubleshooting 文档 的 Forgotten Credentials 一节按安装类型给出了三条命令对应不同的调用方式。先确认你的 Sunshine 是哪种安装类型再选择对应的一条General通过包管理器或源码直接安装、以sunshine命令启动AppImage以./sunshine.AppImage方式运行Flatpak通过 Flatpak 运行appId 为dev.lizardbyte.app.Sunshine。同时准备好新的用户名和密码。注意文档中的提示命令里的{new-username}和{new-password}是占位符必须替换成你实际要使用的新凭据不要保留花括号。执行重置按安装类型选择下面其中一条命令执行# General sunshine --creds {new-username} {new-password}# AppImage ./sunshine.AppImage --creds {new-username} {new-password}# Flatpak flatpak run --commandsunshine dev.lizardbyte.app.Sunshine --creds {new-username} {new-password}三条命令的作用完全相同只是 Sunshine 可执行入口不同--creds后面依次跟新的用户名和新的密码。这条命令只写凭据文件不会影响正在运行的流媒体配置。凭据文件由credentials_file配置项指定默认值为sunshine_state.json见 configuration.md 的credentials_file一节。验证重置是否成功两个判断依据看命令输出。save_user_creds()在成功写入后会记录一条日志见 src/httpcommon.cppNew credentials have been created看到这条信息说明新凭据已经落盘。用新凭据登录 Web UI。打开https://localhost:47990浏览器会提示不安全网站警告这是因为 Sunshine 使用自签名证书忽略即可。输入刚才设置的新用户名和新密码能正常进入 Web UI 即完成重置。失败提示与限制写入失败如果凭据文件不可写src/httpcommon.cpp 中的错误日志会给出提示——error writing to the credentials file, perhaps try this again as an administrator?即建议以管理员权限重试该命令。旧凭据被直接覆盖--creds会用新值写入username、salt和密码哈希原有凭据不可恢复在设置新值前确认自己已经记下了新组合。参数位置固定为--creds username password两者都不能省略。若把help作为用户名或密码传入程序只会打印帮助而不执行重置。重置完成后避免再次进入这个场景的办法只有一个也是官方文档反复强调的把 Web UI 凭据记下来。Sunshine 本身没有找回密码的路径--creds就是唯一的重新设置入口。【免费下载链接】SunshineSelf-hosted game stream host for Moonlight.项目地址: https://gitcode.com/GitHub_Trending/su/Sunshine创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考