### 在 Ubuntu 22.04 上以非 Docker 方式安装 Dify 虽然官方文档推荐通过 Docker 进行部署，但在某些情况下可能需要直接在操作系统上安装并配置 Dify 的依赖项。以下是实现这一目标的具体方法。 #### 系统需求 确保满足以下最低要求： - 操作系统：Ubuntu 22.04 或更高版本。 - Python 版本：3.12（建议使用 Poetry 来管理项目依赖）[^2]。 - Node.js 版本：v18.x LTS（用于前端构建）。 --- #### 步骤一：更新系统包 执行以下命令来更新系统软件包列表，并升级现有包到最新版本： ```bash sudo apt update && sudo apt upgrade -y ``` --- #### 步骤二：安装必要的工具和库 安装编译所需的工具以及 Python 和 Node.js 所需的依赖项： ```bash sudo apt install -y build-essential libssl-dev libffi-dev python3-pip python3-venv curl gnupg ``` 对于 Node.js v18.x LTS，可以通过以下步骤安装： ```bash curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash - sudo apt install -y nodejs node --version npm --version ``` 确认已成功安装 Node.js 并达到所需版本[^2]。 --- #### 步骤三：克隆 Dify 仓库 从 GitHub 下载最新的 Dify 源码： ```bash git clone https://github.com/langgenius/dify.git cd dify/ ``` 如果网络受限，可以尝试使用代理地址： ```bash git clone --depth=1 https://gh-proxy.com/https://github.com/langgenius/dify.git ``` --- #### 步骤四：初始化虚拟环境 进入 `dify` 文件夹后，创建一个新的 Python 虚拟环境： ```bash python3 -m venv env source env/bin/activate pip install --upgrade pip setuptools wheel poetry ``` 使用 Poetry 初始化项目的依赖关系： ```bash poetry config virtualenvs.create true poetry install ``` 这一步会自动解析并安装所有的 Python 库依赖项[^2]。 --- #### 步骤五：配置环境变量 复制 `.env.example` 文件作为基础模板，并根据实际需求修改其中的内容： ```bash cp .env.example .env nano .env ``` 主要关注以下几个字段： - `PORT`: 设置 Web 服务监听的端口号，默认为 `3000`。 - 数据存储路径和其他高级选项可以根据实际情况调整。 保存退出编辑器即可。 --- #### 步骤六：启动应用程序 运行以下命令启动后台服务： ```bash poetry run uvicorn app.main:app --host 0.0.0.0 --port ${YOUR_PORT} ``` 将 `${YOUR_PORT}` 替换为你希望使用的具体端口号码。 与此同时，在另一个终端窗口中切换至前端目录完成静态资源打包工作： ```bash cd frontend npm ci npm run build ``` 完成后重新加载后端进程使更改生效。 --- #### 步骤七：访问系统 打开浏览器输入服务器 IP 地址加上指定端口号（如 http://<server-ip>:3000），按照提示完成初始设置过程包括创建超级管理员账号等操作[^2]。 --- ### 注意事项 由于这种方式绕过了容器化技术带来的隔离优势，请务必注意安全性问题比如防火墙规则设定、敏感数据加密保护等方面的工作。