https://coreychiu.com Corey Chiu's blog Tue, 28 Apr 2026 09:02:48 GMT https://validator.w3.org/feed/docs/rss2.html https://github.com/jpmonette/feed https://coreychiu.com/favicon.ico https://coreychiu.com All rights reserved Corey Chiu 2026 https://coreychiu.com/blogs/how-to-install-n8n-on-dokploy https://coreychiu.com/blogs/how-to-install-n8n-on-dokploy Wed, 09 Jul 2025 00:00:00 GMT 推荐配置：2C2G以上的VPS服务器，支持Docker环境 # 目录 - n8n简介 - 什么是n8n - Dokploy简介 - 什么是Dokploy - 安装Dokploy - 正常安装（推荐） - 国内服务器安装 - 安装n8n - 使用模板安装 - 配置访问域名 - n8n注册使用 - 注册账号 - 激活许可证 - 开始使用 ---- # 什么是n8n [n8n](https://n8n.io) 是一个开源的工作流自动化工具，让你可以通过可视化的方式连接不同的应用和服务，实现自动化任务处理。  简单来说，n8n就像是一个"数字管家"，可以帮你自动完成重复性的工作。比如： - 当有人在你的网站填写表单时，自动发送邮件通知并保存到数据库 - 定时从不同网站抓取数据并整理成报表 - 监控社交媒体提及，自动回复或转发到团队群聊 - 同步不同平台的数据，比如将新订单信息同步到财务系统 n8n的优势： - **完全免费开源**：可以自己部署，数据完全掌控 - **可视化操作**：拖拽式界面，不需要复杂编程 - **丰富的集成**：支持400+种应用和服务连接 - **灵活扩展**：可以用JavaScript编写自定义逻辑 与Dify、Coze等AI平台不同，n8n专注于工作流自动化和系统集成，而不是AI对话或智能体构建，更适合处理数据流转和业务流程自动化。 ---- # 什么是Dokploy [Dokploy](https://dokploy.com) 是一个开源的应用部署解决方案，提供一站式项目、数据的管理以及系统监控。  Dokploy自带多种一键部署模板，可以像Vercel一样地在自己的服务器上部署网站和应用，也可以部署各种数据库（PostgreSQL、MySQL、Redis等）、Docker Compose服务，以及热门的开源工具如n8n、Supabase、Grafana等。最重要的是，所有这些都可以通过可视化界面轻松管理，无需复杂的命令行操作。  # 安装Dokploy ## 正常安装 如果你的服务器能直接访问到Dockerhub,直接拉Docker镜像，比如服务器是阿里云/腾讯云等国内云服务器厂商的境外区域服务器，或者是国外的云服务器厂商，比如Hostinger，那你就可以直接使用官方的安装脚本 ``` curl -sSL https://dokploy.com/install.sh | sh ``` > 如果你还没买服务器，或者对服务器区域没有要求，那么我更建议你直接购买国外的云服务器，安装过程、后续维护都更方便，免去很多潜在的问题。 > > 我自己就买了一台[Hostinger](https://www.hostinger.com/cart?product=vps%3Avps_kvm_2&period=12&referral_type=cart_link&REFERRALCODE=SMCIAMCORWTX&referral_id=0195d1ac-4d34-709b-a1cf-da5744f200e0)的VPS服务器，2C8G配置，100GB的存储空间，8T的带宽，日常卖6.99刀一个月，经常会有搞活动两年只需800多rmb，对比之下还是很实惠的。这个配置也足够个人项目使用了，部署多个应用也不是问题。 > > 并且hostinger服务器自带多种系统模板，**我就是直接选择带dokploy的ubuntu系统安装好就可以了，不需要自己手动安装配置dokploy**。 安装之后的访问域名等dokploy相关配置，可以参考我之前发过的文章，这里就不展开了。 [阿里云ECS国内服务器部署Dokploy教程](https://coreychiu.com/blogs/how-to-install-dokploy-on-aliyun-ecs-server) ## 国内服务器安装 如果你因为个人需求，必须使用国内的服务器部署，也可以参考我之前发过的文章。 [阿里云ECS国内服务器部署Dokploy教程](https://coreychiu.com/blogs/how-to-install-dokploy-on-aliyun-ecs-server) # 安装n8n ## 安装 进入dokploy后台，选择Project - Create Project - Create Service - Template - 选择n8n template   ## 配置访问域名 deploy这个n8n service，会自动给你分配一个traefik的域名，然后你就可以通过这个域名访问n8n了。可以通过点击Domains看到具体的域名。如果要添加自己的域名，也是在Domains中配置。 添加自己的域名还需要更改Enviroment中Environment Settings中的环境变量，将`N8N_HOST`修改为你的域名，然后保存，重新deploy一遍。里面的`N8N_PORT`就是这个service的端口，也是在Domains中配置域名中的`Container port`。    # n8n注册使用 访问前面配置的域名，或者traefik的域名，然后按照提示注册即可。 然后会弹窗提示获取license key，点击send后，会在注册邮箱收到一个n8n的license key，填入即可解锁永久免费的n8n使用。   然后恭喜你，你已经成功安装并配置了n8n，可以愉快地使用了！  官方提供了很多的workflow template供使用，可以直接点击左下角的[template](https://n8n.io/workflows/)访问使用～后面我也会专门再写一篇关于n8n的使用教程与各种实用小技巧，欢迎大家持续关注～ ]]> iamcoreychiu@gmail.com (Corey Chiu) https://coreychiu.com/blogs/how-to-install-dokploy-on-aliyun-ecs-server https://coreychiu.com/blogs/how-to-install-dokploy-on-aliyun-ecs-server Wed, 26 Mar 2025 00:00:00 GMT 我的配置环境：阿里云ECS服务器，配置：2C2G，区域：华东1（杭州），系统：Ubuntu24.04 # 目录 - Dokploy简介 - 什么是Dokploy？ - 安装Dokploy - 正常安装 - 国内服务器安装 - 修改安装脚本 - 配置Docker镜像源 - 运行安装脚本 - 配置防火墙 - 访问后台 - 安装常见问题 - 配置后台 - 绑定域名 - 配置应用 - 配置GitHub - 新建应用 - 直接Deploy - 利用GitHub Action来Deploy - 新建GitHub Token - 配置Registry - 配置Provider - 配置项目Workflow - 配置环境变量 - 配置应用域名 - 常见问题 - 参考代码 ---- # 什么是Dokploy？ [Dokploy](https://dokploy.com) 是一个开源的应用部署解决方案，提供一站式项目、数据的管理以及系统监控。  简单来说就是可以像Vercel一样地在自己的服务器上部署网站，并且还能部署数据库、Docker Compose等开源服务，例如Supabase，并且可以很方便地监控系统及应用日志  # 安装Dokploy ## 正常安装 如果你的服务器能直接访问到Dockerhub,直接拉Docker镜像，比如服务器是阿里云/腾讯云等国内云服务器厂商的境外区域服务器，或者是国外的云服务器厂商，比如Hostinger，那你就可以直接使用官方的安装脚本 ``` curl -sSL https://dokploy.com/install.sh | sh ``` > 如果你还没买服务器，或者对服务器区域没有要求，那么我更建议你直接购买国外的云服务器，安装过程、后续维护都更方便，免去很多潜在的问题。 > > 我自己就买了一台[Hostinger](https://www.hostinger.com/cart?product=vps%3Avps_kvm_2&period=12&referral_type=cart_link&REFERRALCODE=SMCIAMCORWTX&referral_id=0195d1ac-4d34-709b-a1cf-da5744f200e0)的VPS服务器，2C8G配置，100GB的存储空间，8T的带宽，日常卖6.99刀一个月，经常会有搞活动两年只需800多rmb，对比之下还是很实惠的。这个配置也足够个人项目使用了，部署多个应用也不是问题。 ## 国内服务器安装 如果你因为个人需求，必须使用国内的服务器部署，那么就可能会经历跟我一样的问题，你可以按以下步骤来。 1. 先把官方install脚本下载下来 ``` wget https://dokploy.com/install.sh ``` 然后修改以下部分 ``` docker pull postgres:16 docker pull redis:7 docker pull traefik:v3.1.2 docker pull dokploy/dokploy:latest # Installation docker service create \ --name dokploy \ --replicas 1 \ --network dokploy-network \ --mount type=bind,source=/var/run/docker.sock,target=/var/run/docker.sock \ --mount type=bind,source=/etc/dokploy,target=/etc/dokploy \ --mount type=volume,source=dokploy-docker-config,target=/root/.docker \ --publish published=3000,target=3000,mode=host \ --update-parallelism 1 \ --update-order stop-first \ --constraint 'node.role == manager' \ -e ADVERTISE_ADDR=$advertise_addr \ dokploy/dokploy:latest ``` 修改为 ``` docker pull postgres:16 docker pull redis:7 docker pull traefik:v3.1.2 # 修改以下部分 docker pull swr.cn-north-4.myhuaweicloud.com/ddn-k8s/docker.io/dokploy/dokploy:latest docker tag swr.cn-north-4.myhuaweicloud.com/ddn-k8s/docker.io/dokploy/dokploy:latest docker.io/dokploy/dokploy:latest # Installation docker service create \ --name dokploy \ --replicas 1 \ --network dokploy-network \ --mount type=bind,source=/var/run/docker.sock,target=/var/run/docker.sock \ --mount type=bind,source=/etc/dokploy,target=/etc/dokploy \ --mount type=volume,source=dokploy-docker-config,target=/root/.docker \ --publish published=3000,target=3000,mode=host \ --update-parallelism 1 \ --update-order stop-first \ --constraint 'node.role == manager' \ -e ADVERTISE_ADDR=$advertise_addr \ # 修改以下部分 swr.cn-north-4.myhuaweicloud.com/ddn-k8s/docker.io/dokploy/dokploy ``` 2. 修改docker镜像源为阿里云国内源 运行以下命令 ``` # 1. 创建空的daemon.json echo >/etc/docker/daemon.json # 2. 写入docker镜像源 cat>/etc/docker/daemon.json < Secrets and variables -> Actions 点击 "New repository secret" 添加以下信息： Name: `{环境变量名}` Value: `{环境变量值}` 这样设置后，GitHub Actions 在构建 Docker 镜像时就会使用这个环境变量了。 ## 配置应用域名 在Domains页配置想要的域名，然后映射到应用对应的端口，(例如通常NextJS应用是`3000`, Astro应用是`4321`),注意把HTTPS打开，也可以点击右边的骰子按钮来生成一个`xxx.traefik.me`域名，但注意`traefik.me`域名只能用HTTP访问，不要把HTTPS打开。  然后即可使用域名访问。 # 常见问题 1. 用`ip:端口`访问应用/dokploy后台是正常，但用域名访问失败，页面返回`502 currently unable to handle this request.`，请检查你的域名DNS解析是否正常，服务器防火墙是否打开80/443端口，Linux服务器内是否开启了防火墙 # 参考代码 `workflow.yml`参考 ``` # https://docs.github.com/zh/actions/use-cases-and-examples/publishing-packages/publishing-docker-images name: Create and publish a Docker image # Configures this workflow to run every time a change is pushed to the branch called `release`. on: push: branches: ['main'] # Defines two custom environment variables for the workflow. These are used for the Container registry domain, and a name for the Docker image that this workflow builds. env: REGISTRY: ghcr.io IMAGE_NAME: ${{ github.repository }} # There is a single job in this workflow. It's configured to run on the latest available version of Ubuntu. jobs: build-and-push-image: runs-on: ubuntu-latest # Sets the permissions granted to the `GITHUB_TOKEN` for the actions in this job. permissions: contents: read packages: write attestations: write id-token: write # steps: - name: Checkout repository uses: actions/checkout@v4 # Uses the `docker/login-action` action to log in to the Container registry registry using the account and password that will publish the packages. Once published, the packages are scoped to the account defined here. - name: Log in to the Container registry uses: docker/login-action@65b78e6e13532edd9afa3aa52ac7964289d1a9c1 with: registry: ${{ env.REGISTRY }} username: ${{ github.actor }} password: ${{ secrets.GITHUB_TOKEN }} # This step uses [docker/metadata-action](https://github.com/docker/metadata-action#about) to extract tags and labels that will be applied to the specified image. The `id` "meta" allows the output of this step to be referenced in a subsequent step. The `images` value provides the base name for the tags and labels. - name: Extract metadata (tags, labels) for Docker id: meta uses: docker/metadata-action@9ec57ed1fcdbf14dcef7dfbe97b2010124a938b7 with: images: ${{ env.REGISTRY }}/${{ env.IMAGE_NAME }} # This step uses the `docker/build-push-action` action to build the image, based on your repository's `Dockerfile`. If the build succeeds, it pushes the image to GitHub Packages. # It uses the `context` parameter to define the build's context as the set of files located in the specified path. For more information, see "[Usage](https://github.com/docker/build-push-action#usage)" in the README of the `docker/build-push-action` repository. # It uses the `tags` and `labels` parameters to tag and label the image with the output from the "meta" step. - name: Build and push Docker image id: push uses: docker/build-push-action@f2a1d5e99d037542a71f64918e516c093c6f3fc4 with: context: . push: true tags: ${{ steps.meta.outputs.tags }} labels: ${{ steps.meta.outputs.labels }} # environment variables build-args: | NEXT_PUBLIC_ARG1=${{ secrets.NEXT_PUBLIC_ARG1 }} SEC_ARG2=${{ secrets.SEC_ARG2 }} # This step generates an artifact attestation for the image, which is an unforgeable statement about where and how it was built. It increases supply chain security for people who consume the image. For more information, see "[AUTOTITLE](/actions/security-guides/using-artifact-attestations-to-establish-provenance-for-builds)." # - name: Generate artifact attestation # uses: actions/attest-build-provenance@v1 # with: # subject-name: ${{ env.REGISTRY }}/${{ env.IMAGE_NAME}} # subject-digest: ${{ steps.push.outputs.digest }} # push-to-registry: true # Trigger redeploy on dokploy => project webhooks settings - name: Trigger dokploy redeploy run: | curl -X GET {dokploy_webhook} ``` `Dockerfile`参考 ``` # https://github.com/nextauthjs/next-auth-example/blob/main/Dockerfile # syntax=docker/dockerfile:1 FROM node:20-alpine AS base # Install dependencies only when needed FROM base AS deps # Check https://github.com/nodejs/docker-node/tree/b4117f9333da4138b03a546ec926ef50a31506c3#nodealpine to understand why libc6-compat might be needed. RUN apk add --no-cache libc6-compat WORKDIR /app # Install dependencies COPY package.json pnpm-lock.yaml* ./ RUN npm install -g pnpm && pnpm i --frozen-lockfile # Rebuild the source code only when needed FROM base AS builder WORKDIR /app COPY --from=deps /app/node_modules ./node_modules COPY . . # 声明构建参数 ARG ARG1 # 设置环境变量 ENV ARG1=$ARG1 # Next.js collects completely anonymous telemetry data about general usage. # Learn more here: https://nextjs.org/telemetry # Uncomment the following line in case you want to disable telemetry during the build. # ENV NEXT_TELEMETRY_DISABLED 1 RUN npm install -g pnpm \ && mv next.config.docker.mjs next.config.mjs \ && pnpm build # Production image, copy all the files and run next FROM base AS runner WORKDIR /app ENV NODE_ENV production # Uncomment the following line in case you want to disable telemetry during runtime. # ENV NEXT_TELEMETRY_DISABLED 1 RUN addgroup --system --gid 1001 nodejs RUN adduser --system --uid 1001 nextjs COPY --from=builder /app/public ./public # Set the correct permission for prerender cache RUN mkdir .next RUN chown nextjs:nodejs .next # Automatically leverage output traces to reduce image size # https://nextjs.org/docs/advanced-features/output-file-tracing COPY --from=builder --chown=nextjs:nodejs /app/.next/standalone ./ COPY --from=builder --chown=nextjs:nodejs /app/.next/static ./.next/static USER nextjs EXPOSE 3000 ENV PORT 3000 ENV HOSTNAME "0.0.0.0" # server.js is created by next build from the standalone output # https://nextjs.org/docs/pages/api-reference/next-config-js/output CMD ["node", "server.js"] ``` ]]> iamcoreychiu@gmail.com (Corey Chiu) https://coreychiu.com/blogs/ultimate-guide-to-search-engine-submission https://coreychiu.com/blogs/ultimate-guide-to-search-engine-submission Tue, 11 Feb 2025 00:00:00 GMT iamcoreychiu@gmail.com (Corey Chiu) https://coreychiu.com/blogs/github-oauth-setup https://coreychiu.com/blogs/github-oauth-setup Sun, 26 Jan 2025 00:00:00 GMT iamcoreychiu@gmail.com (Corey Chiu) https://coreychiu.com/blogs/google-oauth-setup https://coreychiu.com/blogs/google-oauth-setup Sun, 26 Jan 2025 00:00:00 GMT iamcoreychiu@gmail.com (Corey Chiu) https://coreychiu.com/blogs/webpack-caching-failed-for-pack https://coreychiu.com/blogs/webpack-caching-failed-for-pack Thu, 09 Jan 2025 00:00:00 GMT [webpack.cache.PackFileCacheStrategy] Caching failed for pack: Error: Unable to snapshot resolve dependencies ``` 的问题。 我的项目环境： - Next.js 14.2.9 - pnpm 9.12.3 - node v23.5.0 经过排查，问题有这些特征 - 本地pnpm build/dev时都会有，但线上版本不会有 - 多个项目都有这个问题 - 只在我的笔记本上有，同一个项目在家里的电脑就不会有 因此初步断定为本机pnpm/webpack配置的问题，非项目的问题 经过网上多番搜索、问AI、以及群友寻求帮助，一共试了多个方案，最后终于成功解决，以下记录一下我的经历，希望对大家有帮助。 ## 解决方案 1. 清除缓存重新构建（对我没用） ``` # 清理构建缓存 rm -rf .next rm -rf node_modules/.cache # 清理依赖 rm -rf node_modules rm pnpm-lock.yaml # 清理 pnpm 存储 pnpm store prune # 重新安装依赖 pnpm install # 清理构建缓存后重新构建 pnpm build ``` 这个方案对我不生效，使用完后还是会出现这个问题 2. 删除重复的依赖包，优化依赖树结构（对我没用） ``` # 删除重复的依赖包 pnpm dedupe # 重新安装依赖 pnpm install # 重新构建 pnpm build ``` 这个方案对我不生效，使用完后还是会出现这个问题 3. 使用turbopack而不是webpack（对我没用） 修改**next.config.mjs**配置文件 ``` {{ ... }} const configWithMDX = { ...nextConfig, experimental: { mdxRs: true, turbo: { // 启用 Turbopack enabled: true } }, }; {{ ... }} ``` 这个方案对我不生效，使用完后还是会出现这个问题 4. 修改webpack配置,禁用webpack缓存（有用） 修改**next.config.mjs**配置文件 ``` {{ ... }} const nextConfig = { output: "standalone", reactStrictMode: false, pageExtensions: ["ts", "tsx", "js", "jsx", "md", "mdx"], images: { remotePatterns: [ { protocol: "https", hostname: "*", }, ], }, webpack: (config, { isServer }) => { // 禁用 webpack 缓存以解决构建问题 config.cache = false; return config; }, async redirects() { return []; }, }; {{ ... }} ``` 这个方案是有用的 5. 换用yarn，不用pnpm（没尝试） 理论上可以直接规避问题，不过我一直用的pnpm，所以未尝试]]> iamcoreychiu@gmail.com (Corey Chiu) https://coreychiu.com/blogs/directory-monetization-and-pricing https://coreychiu.com/blogs/directory-monetization-and-pricing Wed, 04 Dec 2024 00:00:00 GMT iamcoreychiu@gmail.com (Corey Chiu)