README.md · Snovel/install

# Frappe 自动安装脚本

这是一个用于自动安装 Frappe/ERPNext 的 Shell 脚本，专为 Ubuntu 系统设计。

## 功能特点

- 自动安装所需的系统依赖
- 配置 MariaDB 数据库
- 安装并配置 Node.js 环境（使用 nvm）
- 支持国内镜像源加速（npm、yarn、pip）
- 自动安装中文字体支持
- 支持开发模式和生产模式配置
- 灵活的应用安装选项
- 自动配置站点和管理员账户
- 支持自定义应用仓库和分支
- 自定义站点名称和管理员密码

## 系统要求

- Ubuntu 24.04 LTS（推荐）
- 非 root 用户，但具有 sudo 权限
- 至少 4GB RAM
- 至少 20GB 磁盘空间

## 使用方法

### 快速安装（使用 curl）

使用 curl 命令一键安装（需要先安装 curl）：

```bash
curl -fsSL https://gitee.com/frappecn/install/raw/master/install.sh | bash -s <用户名>
```

常见安装场景：

1. 安装开发版本：
```bash
curl -fsSL https://gitee.com/frappecn/install/raw/master/install.sh | bash -s myuser --develop
```

2. 安装 ERPNext：
```bash
curl -fsSL https://gitee.com/frappecn/install/raw/master/install.sh | bash -s myuser --install erpnext
```

3. 自定义站点名称和管理员密码：
```bash
curl -fsSL https://gitee.com/frappecn/install/raw/master/install.sh | bash -s myuser --site-name "mysite.local" --admin-password "secure123"
```

注意：使用 curl 安装时，请确保您信任该脚本源。建议在执行前先查看脚本内容。

### 克隆安装（使用 Git）

1. 克隆仓库并准备安装：
```bash
git clone https://gitee.com/frappecn/install.git
cd install
chmod +x install.sh
```

2. 基本安装（仅提供用户名）：
```bash
./install.sh <用户名>
```

3. 高级安装选项：
```bash
./install.sh <用户名> [选项]
```

可用选项：

- `--develop`: 启用开发者模式
- `--install <应用名>`: 安装额外的应用（如 erpnext、hrms）
- `--db-password <密码>`: 设置数据库 root 密码（默认：root）
- `--site-name <站点名>`: 设置站点名称（默认：site1.local）
- `--admin-password <密码>`: 设置管理员密码（默认：admin）
- `--silent`: 启用静默模式，避免系统更新和安装过程中的交互式提示
- `--repo <仓库URL>`: 指定 Frappe 仓库地址
- `--branch <分支名>`: 指定 Frappe 分支（默认：version-15）
- `--bench-dir <目录名>`: 指定 bench 目录名（默认：frappe-bench）
- `--default-app-repo <仓库URL>`: 设置默认应用仓库地址（默认：https://atomgit.com/frappe）
- `--<应用名>-repo <仓库URL>`: 为特定应用设置仓库地址
- `--<应用名>-branch <分支名>`: 为特定应用设置分支

高级安装示例：

1. 安装多个应用并自定义仓库：
```bash
./install.sh myuser --install erpnext --install hrms --erpnext-repo https://atomgit.com/frappe/erpnext
```

2. 指定分支和仓库：
```bash
./install.sh myuser --branch version-15 --repo https://atomgit.com/frappe/frappe
```

3. 使用静默模式安装（适用于自动化部署或系统更新）：
```bash
./install.sh myuser --silent --install erpnext
```

## 安装完成后

安装完成后的操作取决于安装模式：

### 开发模式

进入 bench 目录并启动开发服务器：

```bash
cd frappe-bench
bench start
```

### 生产模式

系统会自动配置生产环境，包括：
- 安装和配置 supervisor
- 设置服务自动启动
- 配置系统服务

## 注意事项

1. 安装过程需要 sudo 权限，但请不要使用 root 用户运行脚本
2. 默认使用国内镜像源加速安装（npm、yarn、pip）
3. 数据库 root 密码默认设置为 'root'
4. 管理员账号默认为 'Administrator'，密码默认为 'admin'
5. 生产模式下会自动安装和配置必要的系统服务
6. 安装完成后，所有文件的所有者会被设置为安装时指定的用户
7. 请确保在生产环境下正确配置域名解析

Snovel/install

简介

发行版

贡献者

近期动态

Snovel/install .gitee-modal { width: 500px !important; }

简介

发行版

贡献者

近期动态

搜索帮助

Snovel/install