#451·BiliNote

[Bug] 无法更改HF_ENDPOINT环境变量,更改成功后也无效

Author: marak999459Created Aug 28, 2026Updated Aug 28, 2026
Labelsbug

受影响的工作区

后端 (backend/)

版本

v2.4.4

部署方式

Docker (docker-compose.yml)

复现步骤

1、本人家庭宽带服务供应商有问题,不管挂不挂梯子,dns都无法解析hf-mirror,且换dns也无效,因此想把HF_ENDPOINT改成huggingface.co,然后走代理去下载whisper模型,于是发现了这个问题。

2、源码中dockerfile.complete,dockerfile和dockerfile.gpu这几个文件中都把HF_ENDPOINT写死成了hf-mirror,结果导致我设定的huggingface.co无效。 无论是用docker run的参数传递进去,还是在.env文件中更改,都只能表面上改掉HF_ENDPOINT(不管是自己compose还是用预构建镜像)。意思就是通过命令查询容器中的HF_ENDPOINT时,确实显示的是huggingface.co,但我下载的时候依然走的是hf-mirror。 推测是snap_download函数在读取HF_ENDPOINT在修改生效之前,所以我改了也不影响下载。

期望行为

建议把这几个文件里的把HF_ENDPOINT=hf-mirror的地方删掉,我自己本地实验后发现删掉这部分内容,自己compose就可以正常走代理去访问huggingface.co下载,而且这几个地方不删掉的话.env文件那里设定HF_ENDPOINT的描述就毫无意义了,不如只在.env里留一个配置HF_ENDPOINT的地方,其他地方删掉。

实际行为

ImageImage

运行环境

No response

日志 / 堆栈

提交前自查

  • 我已搜索过 Issues,确认不是重复问题
  • 我提供的日志中包含 API key、cookie、SESSDATA 等敏感信息