【n8n】Docker容器中安装ffmpeg

容器化部署 n8n 时，常常会遇到一些环境依赖问题。缺少 docker 命令或无法安装 ffmpeg 是较为常见的场景，如果处理不当，会导致流程执行受限。

本文介绍如何在 n8n 容器中解决 docker 命令不可用和 ffmpeg 安装受限的问题，并给出多种可操作的方案，以便在不同环境中选择合适的方式。

问题描述

在实际使用 n8n 容器时，可能会遇到两个问题。
第一个问题是容器内没有 docker 命令，执行时会提示 /bin/sh: docker: not found。这是因为容器中并没有安装 docker 客户端，docker 命令需要在宿主机执行，而不是容器内部。

第二个问题是容器内尝试安装 ffmpeg 时出现权限报错：
ERROR: Unable to lock database: Permission denied
ERROR: Failed to open apk database: Permission denied
这是由于 n8n 容器默认使用 node 用户运行，没有安装软件的权限。

解决方案

一种方式是临时以 root 身份进入容器后手动安装。

docker exec -u 0 -it n8n_dsyt-n8n_dSyT-1 /bin/sh
apk add --no-cache ffmpeg
exit

这样可以立即生效，但安装不会持久保存。

另一种方式是修改容器配置。在 Dockerfile 中切换为 root 用户安装 ffmpeg，再切换回 node 用户：

FROM n8nio/n8n
USER root
RUN apk add --no-cache ffmpeg
USER node

如果使用 docker-compose，也可以直接在配置中加入安装命令：

version: '3'
services:
  n8n:
    image: n8nio/n8n
    user: root
    command: >
      sh -c "
      apk add --no-cache ffmpeg &&
      su node -c 'n8n'"

还有一种方式是通过提交镜像来创建自定义版本：

docker commit n8n_dsyt-n8n_dSyT-1 custom-n8n-with-ffmpeg

之后使用这个镜像来启动容器，就可以直接使用 ffmpeg。

三种方法的核心区别在于持久化与否。手动进入容器安装仅适合临时调试。修改 Dockerfile 或 docker-compose 可以持久化配置，是更推荐的方式。通过 commit 生成镜像则适合快速复用。

注意事项

完成安装后要确保容器最终以 node 用户运行，避免长期使用 root 用户带来的安全风险。如果条件允许，最好在 CI/CD 流程中构建带有 ffmpeg 的镜像，或者直接使用官方已经集成 ffmpeg 的镜像。

总结

n8n 容器中缺少 docker 命令与无法直接安装 ffmpeg，源于运行环境和用户权限的设计。解决方式包括临时进入容器手动安装、在 Dockerfile 或 docker-compose 中加入安装命令、以及通过 commit 创建定制镜像。不同方法在持久化和灵活性上各有侧重。

未来更适合的做法是将依赖集成到自动化构建流程中，生成长期可用的镜像版本，并确保容器最终运行在非 root 用户下，以兼顾安全性与可维护性。