使用Docker创建并运行Bolt.diy

介绍

首先我这里使用的是开源增强版bolt.diy版本
官方有各种安装方式并且有Docker版本，我个人感觉官方的版本太复杂，所以自己创建一个简单的版本使用
本文不介绍bolt是什么，需要可自行百度，全是介绍，很少教程

安装

首先必要说明：

这里最终是在Docker中运行，并且是自己制作镜像，当然可以直接使用官方中的Docker，本文也可以做部分参考

在ubuntu的系统中安装bolt会因为各种依赖导致运行出错，最常见的一个就是：

root@fdd48a12b501:/mnt/bolt.diy# pnpm run dev                                                                                                                  
> bolt@1.0.0 dev /mnt/bolt.diy
> node pre-start.cjs  && remix vite:dev

★═══════════════════════════════════════★
          B O L T . D I Y
         ⚡️  Welcome  ⚡️
★═══════════════════════════════════════★

📍 Current Version Tag: v"1.0.0"
📍 Current Commit Version: "5d3fb1d"
  Please wait until the URL appears here
★═══════════════════════════════════════★
 warn  Data fetching is changing to a single fetch in React Router v7
┃ You can use the `v3_singleFetch` future flag to opt-in early.
┃ -> https://remix.run/docs/en/2.13.1/start/future-flags#v3_singleFetch
┗
Error: write EPIPE
    at afterWriteDispatched (node:internal/stream_base_commons:159:15)
    at writeGeneric (node:internal/stream_base_commons:150:3)
    at Socket._writeGeneric (node:net:966:11)
    at Socket._write (node:net:978:8)
    at writeOrBuffer (node:internal/streams/writable:572:12)
    at _write (node:internal/streams/writable:501:10)
    at Socket.Writable.write (node:internal/streams/writable:510:10)
    at Runtime.updateConfig (/mnt/bolt.diy/node_modules/.pnpm/miniflare@4.20250321.1/node_modules/miniflare/src/runtime/index.ts:154:24)
    at _Miniflare.#assembleAndUpdateConfig (/mnt/bolt.diy/node_modules/.pnpm/miniflare@4.20250321.1/node_modules/miniflare/src/index.ts:1471:28)
    at Mutex.runWith (/mnt/bolt.diy/node_modules/.pnpm/miniflare@4.20250321.1/node_modules/miniflare/src/workers/shared/sync.ts:66:45)
    at _Miniflare.#waitForReady (/mnt/bolt.diy/node_modules/.pnpm/miniflare@4.20250321.1/node_modules/miniflare/src/index.ts:1572:3)
    at _Miniflare._getProxyClient (/mnt/bolt.diy/node_modules/.pnpm/miniflare@4.20250321.1/node_modules/miniflare/src/index.ts:1784:3)
    at _Miniflare.getBindings (/mnt/bolt.diy/node_modules/.pnpm/miniflare@4.20250321.1/node_modules/miniflare/src/index.ts:1807:23)
    at getPlatformProxy (/mnt/bolt.diy/node_modules/.pnpm/wrangler@4.6.0_@cloudflare+workers-types@4.20250327.0/node_modules/wrangler/src/api/integrations/platform/index.ts:118:24)
    at configureServer (/mnt/bolt.diy/node_modules/.pnpm/@remix-run+dev@2.16.3_@remix-run+react@2.16.3_react-dom@18.3.1_react@18.3.1__react@18.3.1_typ_56tyhioi4fkoibvrjndu6yshyi/node_modules/@remix-run/dev/dist/vite/cloudflare-proxy-plugin.js:55:11)
    at _createServer (file:///mnt/bolt.diy/node_modules/.pnpm/vite@5.4.15_@types+node@22.13.14_sass-embedded@1.86.0/node_modules/vite/dist/node/chunks/dep-CevzF2vT.js:63240:20)
    at configResolved (/mnt/bolt.diy/node_modules/.pnpm/@remix-run+dev@2.16.3_@remix-run+react@2.16.3_react-dom@18.3.1_react@18.3.1__react@18.3.1_typ_56tyhioi4fkoibvrjndu6yshyi/node_modules/@remix-run/dev/dist/vite/plugin.js:759:27)
    at async Promise.all (index 3)
    at resolveConfig (file:///mnt/bolt.diy/node_modules/.pnpm/vite@5.4.15_@types+node@22.13.14_sass-embedded@1.86.0/node_modules/vite/dist/node/chunks/dep-CevzF2vT.js:66589:3)
    at _createServer (file:///mnt/bolt.diy/node_modules/.pnpm/vite@5.4.15_@types+node@22.13.14_sass-embedded@1.86.0/node_modules/vite/dist/node/chunks/dep-CevzF2vT.js:62918:18)
    at dev (/mnt/bolt.diy/node_modules/.pnpm/@remix-run+dev@2.16.3_@remix-run+react@2.16.3_react-dom@18.3.1_react@18.3.1__react@18.3.1_typ_56tyhioi4fkoibvrjndu6yshyi/node_modules/@remix-run/dev/dist/vite/dev.js:39:16)
    at Object.viteDev (/mnt/bolt.diy/node_modules/.pnpm/@remix-run+dev@2.16.3_@remix-run+react@2.16.3_react-dom@18.3.1_react@18.3.1__react@18.3.1_typ_56tyhioi4fkoibvrjndu6yshyi/node_modules/@remix-run/dev/dist/cli/commands.js:221:3)
    at Object.run (/mnt/bolt.diy/node_modules/.pnpm/@remix-run+dev@2.16.3_@remix-run+react@2.16.3_react-dom@18.3.1_react@18.3.1__react@18.3.1_typ_56tyhioi4fkoibvrjndu6yshyi/node_modules/@remix-run/dev/dist/cli/run.js:271:7) {
  errno: -32,
  code: 'EPIPE',
  syscall: 'write'
}
 ELIFECYCLE  Command failed with exit code 1.

解决方法就是不要在ubuntu中，基于node镜像制作不会出现这个问题

Dockerfile

你可以直接拿我这里的文件直接用
至少在我这没有问题，解决了后面列出的几个坑

FROM node

RUN cd /root \
    && git clone -b stable https://github.com/stackblitz-labs/bolt.diy.git \
    && cd bolt.diy \
    && npm install -g pnpm \
    && pnpm config set electron_mirror "https://npmmirror.com/mirrors/electron/" \
    && pnpm install

WORKDIR /root/bolt.diy
EXPOSE 5173

CMD ["pnpm", "run", "dev", "--host"]

准备好Dockerfile之后，就可以执行以下命令进行创建镜像了，注意不要删了命令后的点

sudo docker build \
         --build-arg "HTTP_PROXY=http://your-proxy:port/" \
         --build-arg "HTTPS_PROXY=http://your-proxy:port/" \
         --build-arg "NO_PROXY=localhost,127.0.0.1" \
         -t bolt-diy .

如果代理不能进行签名校验，则git和pnpm都会报错证书校验不通过问题

1
2
3

fatal: unable to access 'https://github/xxxxx': SSL certificate problem: unable to get local issuer certificate
# 或者
self signed certificate in certificate chain

那Dockerfile中就需要加入关闭校验的步骤:

点击展开查看Dockerfile

FROM node

RUN cd /root \
    && git config --global http.sslverify false \
    && git clone -b stable https://github.com/stackblitz-labs/bolt.diy.git \
    && cd bolt.diy \
    && npm config set strict-ssl false \
    && npm install -g pnpm \
    && pnpm config set electron_mirror "https://npmmirror.com/mirrors/electron/" \
    && pnpm install

WORKDIR /root/bolt.diy
EXPOSE 5173

CMD ["pnpm", "run", "dev", "--host"]

当然如果你没有代理，那么执行这个，不过可能会因为网络问题导致失败

1	sudo docker build -t bolt-diy .

遇到的问题

git clone failed

网络问题导致无法git

# 报错
fatal: unable to access 'https://github.com/stackblitz-labs/bolt.diy.git/': GnuTLS recv error (-110): The TLS connection was non-properly terminated.
# 或者
fatal: unable to access 'https://github.com/stackblitz-labs/bolt.diy.git/': Failed to connect to github.com port 443 after 136098 ms: Couldn't connect to server

解决方法

使用代理解决，我这里就是通过代理方式解决网络问题
通过镜像源地址进行下载，镜像源网上就比较多了，随便找一个只要能clone下来地址就行
手动下载下来源码包，然后修改Dockerfile文件，直接拿进去使用，就不用git下载了，感兴趣的可以自己搜索教程实践下，我这里不赘述

electron command failed

electron获取失败

171.1 .../core-js@3.41.0/node_modules/core-js postinstall: Done
663.4 .../node_modules/electron postinstall: ReadError: The server aborted pending request
663.4 .../node_modules/electron postinstall:     at IncomingMessage.<anonymous> (/root/bolt.diy/node_modules/.pnpm/got@11.8.6/node_modules/got/dist/source/core/index.js:809:31)
663.4 .../node_modules/electron postinstall:     at Object.onceWrapper (node:events:621:28)
663.4 .../node_modules/electron postinstall:     at IncomingMessage.emit (node:events:519:35)
663.4 .../node_modules/electron postinstall:     at origin.emit (/root/bolt.diy/node_modules/.pnpm/@szmarczak+http-timer@4.0.6/node_modules/@szmarczak/http-timer/dist/source/index.js:43:20)
663.4 .../node_modules/electron postinstall:     at IncomingMessage._destroy (node:_http_incoming:221:10)
663.4 .../node_modules/electron postinstall:     at _destroy (node:internal/streams/destroy:122:10)
663.4 .../node_modules/electron postinstall:     at IncomingMessage.destroy (node:internal/streams/destroy:84:5)
663.4 .../node_modules/electron postinstall:     at TLSSocket.socketCloseListener (node:_http_client:478:11)
663.4 .../node_modules/electron postinstall:     at TLSSocket.emit (node:events:519:35)
663.4 .../node_modules/electron postinstall:     at node:net:346:12
663.4 .../node_modules/electron postinstall: Failed
663.4  ELIFECYCLE  Command failed with exit code 1.

解决方法
哪怕是我挂了代理，还是会出现卡住的现象，没办法，只能更换electron的国内源解决，也就是Dockerfile中的这句：

1 2	# 这是阿里源 pnpm config set electron_mirror "https://npmmirror.com/mirrors/electron/"

当然也可以换成华为源：

1	pnpm config set electron_mirror "https://mirrors.huaweicloud.com/electron/"

网上很多人使用的淘宝源，亲测无效，不知道什么原因，必要的话都可以试试。

使用

Docker image创建好后可以通过这个命令拉起使用，并且向外映射5173端口

1	sudo docker run -d --name bolt -p 0.0.0.0:5173:5173 bolt-diy

然后浏览器打开访问对应服务器ip:5173就可以看到界面了

不知道为什么，拉起docker服务后第一次访问是白屏，刷新一下界面或者重新打开就可以了

呐，diy版本可以配置本地大模型，默认开关是关的，需要在设置Local Providers中手动打开，一共有三个选项

Ollama
一个很强大并简单的开源大模型仓库，可以拉起支持的开源模型
LMStudio
这个没用过
OpenAILike
这个是通用接口，可以对接网络平台，比如我用的是阿里云大模型，就选择的是这个

遇到的问题

代码界面无法显示

控制台报错并且界面不显示

1 2	Failed to spawn bolt shell Failed to execute 'postMessage' on 'Worker': SharedArrayBuffer transfer requires self.crossOriginIsolated.

与其说我遇到的两种情况下会出现这个报错，倒不如说只有一种情况不报这个错误

使用localhost或者127.0.0.1地址进行本地访问
并且配置的大模型是本地的，也是通过本地地址进行访问的
这种情况可以直接使用，不会报错，这也是网上其他教程所表达的
比如在一个设备上搭建Bolt.diy和Ollama，并且在本地浏览器直接访问

跨设备进行访问就会出现这个报错
比如在上述正常情况下，使用另一个设备进行访问就会报错
Bolt和大模型不在一个节点上
比如在一个设备上搭建Bolt.diy，然后在另一个节点上搭建Ollama，或者使用云端大模型，无论本地还是跨节点访问，都会出现此报错

解决方法
网上搜索发现大家遇到这种情况还比较多，总结一下就是**不安全，需要使用HTTPS进行访问**
那这种情况要么配置自己的ssl证书，通过代理转发出去
如果没有证书，那也可以自签名来解决，因为我有自己的ssl，所以不需要做自签，但是这个网上教程非常多，可自行试错！

这里举例可做参考，我没有验过，不保证百分百可用

来源：glamberson issue

样例说明：
这个是自签名证书的过程，非自签的不用创建和导入证书的步骤
部分内容我做了修改，原版请看链接
平台是Linux做服务端，该教程Debian或者Ubuntu均可
Chrome浏览器作为客户端访问

域名解析
因为需要使用域名进行访问，所以需要本地进行DNS
- 如果有自己的域名，那么直接解析即可
- 如果有自己的DNS，那么配置DNS，解析你自己的域名到服务端的IP即可
- 如果没有DNS，那么配置客户端的host文件进行本地解析，这个自行百度本地配置域名解析即可

SSL证书创建配置

# Create directory for CA
sudo mkdir -p /etc/ssl/CA
cd /etc/ssl/CA

# Generate private key for root CA
sudo openssl genrsa -out rootCA.key 4096

# Create root certificate
sudo openssl req -x509 -new -nodes -key rootCA.key -sha256 -days 1024 -out rootCA.crt \
-subj "/C=US/ST=State/L=City/O=Organization/CN=Local Development CA"

# Generate private key for server
sudo openssl genrsa -out /etc/ssl/private/nginx-selfsigned.key 2048

# Create Certificate Signing Request (CSR)
sudo openssl req -new -key /etc/ssl/private/nginx-selfsigned.key \
-out server.csr \
-subj "/CN=dev.example.local"

# Create SAN config file
echo "subjectAltName=DNS:dev.example.local" | sudo tee server.ext

# Sign the certificate
sudo openssl x509 -req -in server.csr \
-CA rootCA.crt -CAkey rootCA.key -CAcreateserial \
-out /etc/ssl/certs/nginx-selfsigned.crt \
-days 365 -sha256 -extfile server.ext

安装和配置nginx服务，进行转发
这里不讲怎么安装和使用，只贴出我的配置文件，原文的配置文件对我不可用🚫

server {
        listen 80;
        server_name bolt.example.com;
        rewrite ^(.*)$ https://${server_name}$1 permanent;
}
server {
        listen 443 ssl http2;           # 启用HTTPS及HTTP/2提升传输性能

        server_name bolt.example.com;
        charset utf-8;

        ssl_certificate /etc/ssl/certs/nginx-selfsigned.crt;
        ssl_certificate_key /etc/ssl/private/nginx-selfsigned.key;

        location / {
                proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
                proxy_set_header X-Forwarded-Proto $scheme;
                proxy_set_header Host $http_host;
                proxy_set_header X-Real-IP $remote_addr;
                proxy_set_header Range $http_range;
                proxy_set_header If-Range $http_if_range;
                proxy_redirect off;
                proxy_pass http://your_ip:5173;  # 这里填写bolt的ip和端口号
                # the max size of file to upload
                client_max_body_size 20000m;
        }
}

导入证书到Chrome浏览器
- 证书文件是：/etc/ssl/CA/rootCA.crt，把它拿到客户端设备上
- 在浏览器里：
  - Settings > Privacy and security > Security > Manage certificates
  - Import to “Trusted Root Certification Authorities”
  - Restart Chrome

至此结束

域名被拒绝

vite拒绝访问该域名

1 2	Blocked request. This host ("bolt.example.com") is not allowed. To allow this host, add "bolt.example.com" to `server.allowedHosts` in vite.config.js.

vite官网上解释如下:

解决方法
将对应配置参数添加进配置文件中即可，因为我使用的docker，所以直接重新做镜像加入就行：

FROM node

RUN cd /root \
    && git clone -b stable https://github.com/stackblitz-labs/bolt.diy.git \
    && cd bolt.diy \
    && sed -i "/^[[:space:]]*build:/i\    server: { allowedHosts: ['bolt.example.com'] }," vite.config.ts \
    && npm install -g pnpm \
    && pnpm config set electron_mirror "https://npmmirror.com/mirrors/electron/" \
    && pnpm install

WORKDIR /root/bolt.diy
EXPOSE 5173

CMD ["pnpm", "run", "dev", "--host"]