condor
212 lines
9.1 KiB
Markdown
212 lines
9.1 KiB
Markdown
# ServerStack 脚本使用说明
|
||
|
||
> 适用版本：当前项目（重构 + 软件裁剪 + 仅支持 Debian 9-13 / Ubuntu 16-26）。
|
||
> 所有命令**必须以 root 身份**在目标 Linux 服务器上运行。
|
||
> 项目根目录约定为 `ServerStack/`，入口脚本都在 `bin/` 下，**请在该项目根目录执行**。
|
||
|
||
---
|
||
|
||
## 0. 通用说明
|
||
|
||
- **交互模式**：直接运行脚本，按菜单提示逐项选择。
|
||
- **无人值守（CLI）模式**：在脚本后加长选项，可跳过菜单直接安装。
|
||
- 安装日志：`runtime/install.log`。
|
||
- 版本与路径配置：`config/versions.txt`、`config/options.conf`。
|
||
- 若 SSH 端口非 22，安装脚本会提示并写入 `/etc/ssh/sshd_config`（可选防火墙 `--iptables`）。
|
||
|
||
---
|
||
|
||
## 1. 主安装 `bin/install.sh`
|
||
|
||
### 1.1 交互模式
|
||
```bash
|
||
cd ServerStack
|
||
bash bin/install.sh
|
||
```
|
||
菜单依次询问（可全部选 `n` 跳过某类）：
|
||
|
||
| 步骤 | 选项 | 说明 |
|
||
|------|------|------|
|
||
| Web 服务器 | y/n | 是否安装 Web |
|
||
| Nginx | `1` 安装 / `2` 不安装 | 仅保留 Nginx（已裁剪 Apache/Tengine/OpenResty） |
|
||
| 数据库 | y/n | 是否安装 DB |
|
||
| DB 版本 | `1` MySQL-8.0 / `2` MySQL-5.7 / `3` MariaDB-10.11 / `4` MariaDB-11.8 / `5` MariaDB-12.3 / `6` PostgreSQL-15.14 / `7` PostgreSQL-16.10 / `8` PostgreSQL-17.6 / `9` MongoDB | 9 选 1（默认 `2`） |
|
||
| DB 安装方式 | `1` 二进制包 / `2` 源码编译 | 仅 MySQL/MariaDB 出现（默认 `1`） |
|
||
| DB 密码 | 输入或回车用随机密码 | MySQL/MariaDB→root；PG→postgres；Mongo→root |
|
||
| PHP | y/n | 是否安装 PHP |
|
||
| PHP 版本 | `1` php-7.4 / `2` php-8.0 / `3` php-8.1 | 3 选 1（默认 `1`） |
|
||
| OPcode 缓存 | y/n → `1` Zend OPcache / `2` APCu | |
|
||
| PHP 扩展 | 多选编号，如 `4 11 12` | 0 不装；可用 imagick/gmagick/fileinfo/imap/ldap/phalcon/yaf/redis/mongodb/swoole/xdebug 等 |
|
||
| Node.js | y/n | |
|
||
| Pure-FTPd | y/n | |
|
||
| phpMyAdmin | y/n | |
|
||
| redis-server | y/n | |
|
||
| iptables | y/n | 是否启用防火墙 |
|
||
|
||
### 1.2 无人值守（CLI）示例
|
||
```bash
|
||
# 安装 Nginx + MySQL-8.0(二进制) + PHP-8.1(OPcache) + redis，结束不重启
|
||
bash bin/install.sh --nginx_option 1 --db_option 1 --dbinstallmethod 1 \
|
||
--dbrootpwd 'YourDBpass123' --php_option 3 --phpcache_option 1 \
|
||
--php_extensions "fileinfo redis" --redis
|
||
|
||
# 只装 PostgreSQL-17.6，并启用防火墙、装完后重启
|
||
bash bin/install.sh --db_option 8 --dbrootpwd 'PgPass123' \
|
||
--iptables --reboot
|
||
```
|
||
常用 CLI 参数：
|
||
|
||
| 参数 | 取值 | 说明 |
|
||
|------|------|------|
|
||
| `--nginx_option` | `1`/`2` | 1 安装 Nginx，2 不安装 |
|
||
| `--php_option` | `1`/`2`/`3` | php-7.4 / 8.0 / 8.1 |
|
||
| `--mphp_ver` | `74`/`80`/`81` | 多版本 PHP 共存（配合 `--mphp_addons`） |
|
||
| `--mphp_addons` | 无值 | 为 mphp 版本安装附加组件 |
|
||
| `--phpcache_option` | 编号 | PHP OPcode 缓存选择 |
|
||
| `--php_extensions` | 扩展名列表 | 空格分隔，如 `imagick redis swoole` |
|
||
| `--db_option` | `1`–`9` | 见上表 |
|
||
| `--dbinstallmethod` | `1`/`2` | 1 二进制，2 源码 |
|
||
| `--dbrootpwd` | 字符串 | 数据库超级密码（同时用于 PG/Mongo） |
|
||
| `--pureftpd` | 无值 | 安装 Pure-FTPd |
|
||
| `--redis` | 无值 | 安装 Redis |
|
||
| `--phpmyadmin` | 无值 | 安装 phpMyAdmin |
|
||
| `--python` / `--nodejs` | 无值 | 安装 Python / Node.js |
|
||
| `--ssh_port` | 端口号 | 修改 SSH 端口 |
|
||
| `--iptables` | 无值 | 启用 iptables 防火墙 |
|
||
| `--reboot` | 无值 | 安装完成后重启 |
|
||
| `-h/--help` | 无值 | 查看帮助 |
|
||
|
||
---
|
||
|
||
## 2. 卸载 `bin/uninstall.sh`
|
||
```bash
|
||
bash bin/uninstall.sh --all # 卸载全部
|
||
bash bin/uninstall.sh --web # 仅卸载 Nginx
|
||
bash bin/uninstall.sh --mysql # 卸载 MySQL/MariaDB
|
||
bash bin/uninstall.sh --postgresql # 卸载 PostgreSQL
|
||
bash bin/uninstall.sh --mongodb # 卸载 MongoDB
|
||
bash bin/uninstall.sh --php # 卸载主 PHP
|
||
bash bin/uninstall.sh --mphp_ver 81 # 卸载某个多版本 PHP（74/80/81）
|
||
bash bin/uninstall.sh --allphp # 卸载所有 PHP
|
||
bash bin/uninstall.sh --phpcache # 卸载 PHP OPcode 缓存
|
||
bash bin/uninstall.sh --php_extensions redis # 卸载指定 PHP 扩展
|
||
bash bin/uninstall.sh -q # 静默模式
|
||
```
|
||
|
||
---
|
||
|
||
## 3. 升级 `bin/upgrade.sh`
|
||
```bash
|
||
bash bin/upgrade.sh --nginx [版本] # 升级 Nginx
|
||
bash bin/upgrade.sh --db [版本] # 升级 MySQL/MariaDB
|
||
bash bin/upgrade.sh --php [版本] # 升级 PHP
|
||
bash bin/upgrade.sh --redis [版本] # 升级 Redis
|
||
bash bin/upgrade.sh --phpmyadmin [版本]
|
||
bash bin/upgrade.sh --oneinstack # 升级 ServerStack 自身到最新
|
||
bash bin/upgrade.sh --acme.sh # 升级 acme.sh
|
||
bash bin/upgrade.sh -h
|
||
```
|
||
> 版本号省略时自动取官方最新稳定版。
|
||
|
||
---
|
||
|
||
## 4. 虚拟主机 `bin/vhost.sh`
|
||
```bash
|
||
bash bin/vhost.sh --add # 交互式新增站点（含 SSL 选项）
|
||
bash bin/vhost.sh --list # 列出所有虚拟主机
|
||
bash bin/vhost.sh --delete # 删除虚拟主机
|
||
bash bin/vhost.sh --mphp_ver 81 # 指定多版本 PHP（74/80/81）
|
||
bash bin/vhost.sh --proxy # 反向代理模式
|
||
bash bin/vhost.sh --httponly # 仅 HTTP
|
||
bash bin/vhost.sh --selfsigned # 自签名 SSL
|
||
bash bin/vhost.sh --letsencrypt # Let's Encrypt 免费证书
|
||
bash bin/vhost.sh --dnsapi # 用 DNS API 自动签发证书
|
||
```
|
||
新增站点时会提示：域名、根目录、是否开启 rewrite（内置 discuz/wordpress/typecho/thinkphp 等模板）、PHP 版本、SSL 方式。
|
||
|
||
---
|
||
|
||
## 5. 扩展/安全组件 `bin/addons.sh`
|
||
```bash
|
||
bash bin/addons.sh --install --composer # 安装 Composer
|
||
bash bin/addons.sh --install --fail2ban # 安装 Fail2ban（SSH 防暴破）
|
||
bash bin/addons.sh --install --ngx_lua_waf # 安装 Nginx Lua WAF
|
||
bash bin/addons.sh --install --python # 安装 Python
|
||
bash bin/addons.sh --uninstall --composer # 卸载对应组件
|
||
bash bin/addons.sh -h
|
||
```
|
||
|
||
---
|
||
|
||
## 6. 备份 `bin/backup_setup.sh` + `bin/backup.sh`
|
||
|
||
### 6.1 配置备份目标 `backup_setup.sh`
|
||
```bash
|
||
bash bin/backup_setup.sh
|
||
```
|
||
交互选择备份目的地（1 本机 / 2 远程主机 / 3 阿里云 OSS / 4 腾讯云 COS / 5 又拍云 / 6 七牛 / 7 AWS S3 / 8 Dropbox），并按提示输入对应凭据（均交互输入，不写入脚本）。
|
||
|
||
设置会生成 `config_backup.txt`（含远程主机 IP/用户/口令——**明文存储，请妥善保管**）。
|
||
|
||
### 6.2 执行备份 `backup.sh`
|
||
```bash
|
||
bash bin/backup.sh
|
||
```
|
||
按 settings 自动备份：网站目录、数据库（本地+可选远程/对象存储）、并清理过期备份。
|
||
> 远程/对象存储备份底层会调用 `scripts/` 下的 `db_bk.sh`、`mabs.sh` 等批量运维工具，需 `backup_setup.sh` 已配置好目标。
|
||
|
||
---
|
||
|
||
## 7. FTP 用户管理 `bin/pureftpd_vhost.sh`
|
||
```bash
|
||
bash bin/pureftpd_vhost.sh --add -u ftpuser -p pass -d /data/www # 新增 FTP 用户
|
||
bash bin/pureftpd_vhost.sh --usermod -u ftpuser -d /new/dir # 改主目录
|
||
bash bin/pureftpd_vhost.sh --passwd -u ftpuser -p newpass # 改密码
|
||
bash bin/pureftpd_vhost.sh --delete -u ftpuser # 删用户
|
||
bash bin/pureftpd_vhost.sh --list # 列出所有用户
|
||
bash bin/pureftpd_vhost.sh --showuser -u ftpuser # 查看用户详情
|
||
```
|
||
|
||
---
|
||
|
||
## 8. 重置数据库 root 密码 `bin/reset_db_root_password.sh`
|
||
```bash
|
||
bash bin/reset_db_root_password.sh -p 'NewPass123' # 用新密码重置
|
||
bash bin/reset_db_root_password.sh -f # 忘记旧密码，强制重置
|
||
bash bin/reset_db_root_password.sh -q # 静默
|
||
bash bin/reset_db_root_password.sh -h
|
||
```
|
||
> 默认会生成 8 位随机密码（无 `-p` 时），重置后请在输出中记录。
|
||
|
||
---
|
||
|
||
## 9. `scripts/` 运维辅助（非安装必需，手动调用）
|
||
|
||
| 脚本 | 用途 | 注意 |
|
||
|------|------|------|
|
||
| `scripts/db_bk.sh <库名>` | 单库备份 | 被 backup.sh 调用 |
|
||
| `scripts/website_bk.sh` | 网站目录备份 | 被 backup.sh 调用 |
|
||
| `scripts/mabs.sh` + `thread.sh` + `mssh.exp` + `mscp.exp` | 多主机批量 SSH/SCP 推送与命令执行 | 需自备 `iplist.txt`/`config.txt`；明文存远程口令；不会自动触发 |
|
||
| `scripts/ckssh.py` | 检测某 IP 的 SSH 端口是否通 | 仅 TCP 连通性检测 |
|
||
|
||
---
|
||
|
||
## 10. 注意事项（与上游 OneinStack 的差异）
|
||
|
||
1. **仅支持 Debian 9-13 / Ubuntu 16-26**（apt-get 系）；RHEL/CentOS 等会直接退出。
|
||
2. **软件已裁剪**：Web 仅 Nginx；DB 仅 MySQL/MariaDB/PostgreSQL/MongoDB；缓存仅 Redis；移除 Tengine/OpenResty/Apache/Percona/Memcached/Tomcat/OpenJDK。
|
||
3. **PHP 仅 7.4 / 8.0 / 8.1**；多版本共存仅支持这三者。
|
||
4. **Nginx 已精简**：不含 rtmp 流媒体与 fancyindex 目录美化模块。
|
||
5. 安装日志路径为 `runtime/install.log`（向上游 `install.log` 内容一致）。
|
||
|
||
---
|
||
|
||
## 11. 快速参考（一条命令装常用栈）
|
||
```bash
|
||
# LNMP + Redis + phpMyAdmin，装完重启
|
||
cd ServerStack
|
||
bash bin/install.sh --nginx_option 1 --db_option 1 --dbinstallmethod 1 \
|
||
--dbrootpwd 'DBpass!2026' --php_option 3 --phpcache_option 1 \
|
||
--php_extensions "fileinfo redis" --redis --phpmyadmin --reboot
|
||
```
|