跳到正文
MyDSH我的 DSH 实战笔记
English
独立维护,非DeepSeek官方;与mydsh.dev等其他MyDSH站点无关联。

首页/起步与安装/命令行与Web界面

启动参数与默认值:--host / --port / --no-open / --trusted-host

想让局域网里别的设备也能访问、想换端口、或者不想每次启动都弹浏览器。

已核验版本与环境核验日期2026-11-14
宿主版本
0.1.2-alpha.5
参数来源
dsh web --help原文
核验日期
2026-11-14

可复制指令

dsh web --help

启动器的参数和web应用自己的参数是两层,容易混。启动器管「启动哪个profile」,应用管「怎么服务」。

启动器(dsh 本身)

参数作用
--profile <name>启动 $DSH_HOME/profiles下的某个profile
--patch <path>在profile之上再加一层补丁,可重复
--dump-config打印合成后的配置树然后退出
--dump-default-config打印不带用户层的配置树然后退出
-V, --version打印版本号

web 应用自己的参数

Usage: dsh --profile web [options]

  --host <host>                  bind host
  --no-open                      do not open the Web UI in the default browser
  --port <port>                  listen port; pass 0 to let the OS pick a free one
  --trusted-host <authority...>  extra authority the /api browser-trust fence accepts
  -h, --help                     show this help

几个值得记住的默认行为:

  • --port 0会向操作系统要一个空闲端口,启动时会打印实际用了哪个。端口冲突又不想杀进程时,这条最省事。
  • --no-open只是不弹浏览器,URL照样打印,token照样生成。自启脚本常用它。
  • --trusted-host不是用来关掉鉴权的,它是给 /api的信任围栏追加白名单。想从另一台机器访问,光改host不够,还要处理这个围栏。
  • --host绑到0.0.0.0意味着局域网可访问。做这件事之前先想清楚:同一网络里任何人拿到token就能用你的额度和你的文件权限。
想给局域网用,更稳的做法是保持127.0.0.1绑定,用SSH隧道或反向代理加一层自己的鉴权;直接把0.0.0.0暴露出去,等于把文件系统权限挂在一个43字符的串上。

自己看当前版本的全部参数

dsh --help
dsh web --help

参数随版本变。0.2.x与0.1.x就差了几项,别拿旧文章的参数表对着新版本试。

怎么算跑通

照着逐条对,全过才算完成。有一条没过,先解决它再往下。

  • dsh web --help能列出四个参数
  • --port 0时启动打印了实际端口
  • --no-open时没有弹浏览器但URL照常打印

会失败在哪

现象 / 原因 / 怎么办,按实际踩到的顺序写。

现象原因怎么办
--host 0.0.0.0后别的设备还是打不开只改了绑定,没处理 /api的信任围栏用 --trusted-host加白名单,或干脆走SSH隧道
参数报unknown option版本不支持这个参数用dsh web --help看当前版本支持什么

来源

标「已核验」的,来自本站实跑;标「公开资料整理」的,逐条附出处。