如何 Docker 化 SvelteKit

本指南将指导您如何容器化 sveltekit 应用，简化部署和管理。请注意：本指南针对 sveltekit，而非 svelte。

准备工作

如果您还没有 SvelteKit 项目，可以使用以下命令创建：

<code class="bash">npx sv create my-svelte-app --template demo --types ts</code>

接下来，我们需要配置 SvelteKit 使用 adapter-node 适配器，这是容器化的关键。

安装 adapter-node：

<code class="bash">npm i -D @sveltejs/adapter-node</code>

然后，打开 svelte.config.js 并修改适配器配置：

<code class="javascript">// svelte.config.js
- import adapter from '@sveltejs/adapter-auto';
+ import adapter from '@sveltejs/adapter-node';</code>

Dockerfile 配置

接下来，创建 Dockerfile，定义 Docker 如何构建和运行您的应用。以下是一个示例：

<code class="dockerfile"># 构建阶段
FROM node:22-alpine AS builder
WORKDIR /app
COPY package*.json ./
RUN npm ci
COPY . .
RUN npm run build
RUN npm prune --production

# 运行阶段
FROM node:22-alpine
WORKDIR /app
COPY --from=builder /app/build build/
COPY --from=builder /app/node_modules node_modules/
COPY package.json .
EXPOSE 3000
ENV NODE_ENV=production
CMD ["node", "build"]</code>

Dockerfile 说明：

1. 构建阶段: 基于 Node.js Alpine 镜像，安装依赖，构建 SvelteKit 应用，并移除开发依赖。
2. 运行阶段: 基于另一个 Node.js Alpine 镜像，复制构建产物和生产依赖，设置环境变量，并启动应用。

为了保持 Docker 构建上下文简洁，创建 .dockerignore 文件：

<code>Dockerfile
.dockerignore
.git
.gitignore
.gitattributes
README.md
.npmrc
.prettierrc
.eslintrc.cjs
.graphqlrc
.editorconfig
.svelte-kit
.vscode
node_modules
build
package
**/.env</code>

多阶段构建有助于减小最终镜像大小并提高构建速度。

建议将所有依赖项安装为开发依赖 (-D)，例如 npm i -D lucide-svelte。 这允许 SvelteKit 捆绑必要的依赖项。如果在构建过程中遇到问题（例如 __dirname 未定义），则可能需要将部分依赖项安装为普通依赖项。 如果所有依赖项都是开发依赖，则可以在运行阶段跳过复制 node_modules，进一步减小镜像大小。

构建和运行

在包含 Dockerfile 的目录中执行以下命令构建镜像：

<code class="bash">docker build -t my-sveltekit-app .</code>

构建完成后，使用以下命令运行容器：

PathFinder

AI驱动的销售漏斗分析工具

下载

<code class="bash">docker run -p 3000:3000 my-sveltekit-app</code>

现在，您可以在浏览器访问 http://localhost:3000 来查看您的应用。

环境变量

在 Docker 中管理环境变量至关重要。SvelteKit 提供四种导入环境变量的方式：

1. $env/dynamic/private: 运行时变量，可在运行时设置。
2. $env/dynamic/public: 运行时变量，暴露给客户端。
3. $env/static/private: 构建时变量，嵌入到镜像中。
4. $env/static/public: 构建时变量，暴露给客户端。

部署提示

部署时，请注意不同平台处理构建时和运行时环境变量的方式。 参考目标平台的文档。 处理表单提交等服务器端功能时，需要正确设置 origin 环境变量，避免 CORS 错误：

<code class="bash">docker run -p 3000:3000 -e ORIGIN=http://localhost:3000 my-sveltekit-app</code>

生产环境中，将 http://localhost:3000 替换为您的实际域名。

高级技巧

1. 健康检查: 添加 /health 端点并使用 Docker 的 HEALTHCHECK 指令监控容器健康状况。

2. 内存限制: 设置 Node.js 内存限制，防止容器崩溃。

3. 安全扫描: 定期扫描容器漏洞。

总结

现在您已成功容器化您的 SvelteKit 应用。 如需部署，可参考 sliplane.io。