内网环境下Dify1.9.0版本镜像构建过程记录

发布日期：2025-09-26 07:08:58 浏览次数： 2737

作者：陈大金说

微信搜一搜，关注“陈大金说”

最近dify发布了1.9.0版本，正好本地也准备升级Dify，索性直接升到1.9.0版本，这次准备将Dify-api镜像也一并构建了。这里将构建过程进行记录，方便后续进行复盘、参考。

一、Dify-API镜像构建

整个过程比较简单，主要的工作是修改Dockerfile文件，然后执行构建命令。由于是内网环境（非互联网），中间有几处修改内容需要注意一下。

1、【修改】使用本地python3.12基础镜像包

FROM python-3.12:2507241906 AS base

2、【增加】设置本地Pip、uv源

ENV UV_INDEX_URL=https://mirrors.xxxxxxx.com/pypi/simple

ENV PIP_INDEX_URL=${UV_INDEX_URL}

ENV UV_TRUSTED_HOST=mirrors.xxxxxx.com

ENV PIP_TRUSTED_HOST=${UV_TRUSTED_HOST}

3、【增加参数】保证容器内pip install命令可执行

RUN pip install --no-cache-dir uv==${UV_VERSION} --break-system-packages

4、【修改】debin源

RUN sed -i 's@deb.debian.org@mirrors.xxxxxxx.com@g' /etc/apt/sources.list.d/debian.sources

5、【新增】“uv lock”命令更新锁文件，否则下一条uv sync命令会执行失败，

# Install Python dependencies

COPY pyproject.toml uv.lock ./

RUN uv lock

RUN uv sync --locked --no-dev

6、'punkt'、'averaged_perceptron_tagger'依赖包下载失败，原因是内网无法直接使用命令下载外部包，因此先【离线下载】到本地，然后放置到以下位置（外网可忽略）。

api/

├── docker/

│ └── nltk_data/

│ ├── tokenizers/punkt/

│ └── taggers/averaged_perceptron_tagger/

【修改】命令：

# 注释在线下载命令

# RUN python -c "import nltk; nltk.download('punkt');..."

COPY docker/nltk_data /root/nltk_data

7、同样，tiktoken_cache在内网也会下载失败，需要【离线下载】并放置到以下目录（外网可忽略）

api/

├── docker/

|--tiktoken_cache/

├── encoder.json

└── vocab.bpe

【修改】命令

# 注释在线下载命令

# RUN python -c "import tiktoken; tiktoken.encoding_for_model('gpt2')"

COPY docker/tiktoken_cache $TIKTOKEN_CACHE_DIR

至此，Dify-api Dockerfile文件修改完成，在dify/api目录下执行以下命令可正常编译。

docker build . -t dify-api:1.9.0.1

二、Dify-web镜像编构建

之前在1.6.0版本上Dify-web镜像已经构建成功，原本以为1.9.0版本过程会比较简单，没想到还是遇到了几个新的问题。

1、【修改】基础镜像为本地镜像

FROM node:22-alpine3.21 AS base

2、【修改】镜像源

RUN sed -i 's/dl-cdn.alpinelinux.org/mirrors.xxx.com/g' /etc/apk/repositories

3、【修改】配置npm

RUN npm config set registry https://mirrors.xxxx.com/npm/

说明：我在1.6.0版本编译里面自行新增的一条指令，在1.9.0里面竟然在官方上出现了，哈哈~

4、当前内网虽然有npm源，但是通过接口拿到的pnpm包的下载地址还是外网的地址，这里也只能【离线下载】pnpm-10.15.0.tgz文件，并放置到以下目录：

web/

├── docker/

│ └── pnpm.tgz

【新增】拷贝命令：

COPY docker/pnpm-10.15.0.tgz /tmp/pnpm-10.15.0.tgz

并在base阶段【新增】pnpm安装命令

# 将pnpm-10.15.0安装命令调整到base阶段

RUN npm -g --force install /tmp/pnpm-10.15.0.tgz && \

rm /tmp/pnpm-10.15.0.tgz # 安装后清理

【注释】corepack相关的两条命令

# RUN corepack enable

# RUN corepack install

这里的两个坑集中说一下：

（1）“corepack install”命令会从npm源下载pnpm包并安装，因为内网npm源的问题，这个命令是不能用的，所以这里需要注释掉corepack相关的命令，并增加手动安装pnpm命令。

（2）其次，之前脚本中的corepack install命令是在packages阶段执行的，也就是说pnpm工具只在packages阶段中可用。但是后面的builder、production阶段都是基于base构建，也都使用了pnpm工具，这个时候就都会报错。所以我这里将pnpm工具构建的命令调整到了base阶段，保证后面基于base构建的packages、builder以及production阶段均可使用pnpm工具。