From 4d551eeda152c3ae4f3cef8d082dfa26490a16c6 Mon Sep 17 00:00:00 2001
From: spiritlhl <103393591+spiritLHLS@users.noreply.github.com>
Date: Tue, 20 Jun 2023 02:38:36 +0000
Subject: [PATCH] Push
---
docs/en_US/guide/dashboard.md | 5 +--
docs/en_US/guide/docker_build.md | 8 ++---
docs/en_US/guide/lxd_extra_config.md | 11 +++++--
docs/en_US/guide/lxd_install.md | 6 ++--
docs/en_US/guide/lxd_lxc.md | 46 ++++++++++++++++++++--------
docs/en_US/guide/lxd_precheck.md | 14 +++++++--
docs/en_US/guide/pve_install.md | 6 +++-
docs/en_US/guide/pve_kvm.md | 44 ++++++++++++++------------
docs/en_US/guide/pve_lxc.md | 15 ++++++++-
docs/en_US/guide/pve_precheck.md | 22 ++++++++-----
10 files changed, 123 insertions(+), 54 deletions(-)
diff --git a/docs/en_US/guide/dashboard.md b/docs/en_US/guide/dashboard.md
index d986fef2bb..a271d2d3cb 100644
--- a/docs/en_US/guide/dashboard.md
+++ b/docs/en_US/guide/dashboard.md
@@ -1,4 +1,4 @@
-# 准备工作
+## 准备工作
需要虚拟化出服务器,你需要:
1. 一台可以连接公网的服务器( VPS 或 Dedicated Server),最好能完美访问 Github 的 RAW 页面,部分项目部分组件可能未使用 CDN 加速
@@ -12,13 +12,14 @@
3. 确保服务器的系统和硬件满足对应项目的要求,详见对应项目说明
**本文档将以VPS作为范例,且该VPS纯净,无原生环境问题,如有必要请重装系统保证初始环境的纯净**
+
:::warning
PVE项目可能造成宿主机出现问题,如果你不会看Bug和修复系统,那么不建议你在生产环境中使用,使用PVE相关脚本请确保宿主机随时可重装系统
:::
## 项目仓库
-欢迎Star和Fork,如有问题,对应仓库的issues提出,有空会看看与解决,当然仅限脚本相关问题
+欢迎Star和Fork
### PVE相关的各种一键脚本
diff --git a/docs/en_US/guide/docker_build.md b/docs/en_US/guide/docker_build.md
index 01e248f357..2a9e06ea03 100644
--- a/docs/en_US/guide/docker_build.md
+++ b/docs/en_US/guide/docker_build.md
@@ -1,5 +1,3 @@
-# Docker虚拟化
-
## 单独开设
下载脚本
@@ -24,7 +22,7 @@ curl -L https://ghproxy.com/https://raw.githubusercontent.com/spiritLHLS/docker/
目前system仅支持选择alpine或debian,默认是debian
-## 示例
+### 示例
* 以下为开设的示例容器的信息:
`容器名字` - test
@@ -56,7 +54,7 @@ docker exec -it test /bin/bash
要退出容器就执行```exit```退出。
-## 查询信息
+### 查询信息
```shell
cat 容器名字
@@ -105,4 +103,4 @@ cat dclog
docker rm -f $(docker ps -aq); docker rmi $(docker images -aq)
rm -rf dclog
ls
-```
+```
\ No newline at end of file
diff --git a/docs/en_US/guide/lxd_extra_config.md b/docs/en_US/guide/lxd_extra_config.md
index 668ac9875b..197f0c7edb 100644
--- a/docs/en_US/guide/lxd_extra_config.md
+++ b/docs/en_US/guide/lxd_extra_config.md
@@ -1,5 +1,10 @@
+# 其他自定义配置
+
:::tip
以下的配置安装会加重母鸡的负担,非必要不要安装
+:::
+
+:::tip
如果是个人使用,可忽略防滥用部分脚本的安装
:::
@@ -76,7 +81,7 @@ curl -L https://raw.githubusercontent.com/spiritLHLS/lxc/main/scripts/rules.sh -
curl -L https://ghproxy.com/https://raw.githubusercontent.com/spiritLHLS/lxc/main/scripts/rules.sh -o rules.sh && chmod +x rules.sh && bash rules.sh
```
-##### 使用screen配置监控屏蔽某些进程的执行遇到某些进程的出现直接关闭容器
+## 使用screen配置监控屏蔽某些进程的执行遇到某些进程的出现直接关闭容器
- 如需停止监控可使用```screen```命令停止```lxc_moniter```这个名字的窗口并删除
- (***非必须***,该脚本仅仅是为了防止容器滥用方便,不装的也没问题)
@@ -94,7 +99,7 @@ curl -L https://raw.githubusercontent.com/spiritLHLS/lxc/main/scripts/build_moni
curl -L https://ghproxy.com/https://raw.githubusercontent.com/spiritLHLS/lxc/main/scripts/build_monitor.sh -o build_monitor.sh && chmod +x build_monitor.sh && bash build_monitor.sh
```
-##### 一键安装开lxd母鸡所需要的带vnstat环境的常用预配置环境
+## 一键安装开lxd母鸡所需要的带vnstat环境的常用预配置环境
- (***非必须***,该脚本仅仅是为了站点对接监控方便,不装的也没问题)
@@ -110,7 +115,7 @@ curl -L https://raw.githubusercontent.com/spiritLHLS/lxc/main/scripts/backend.sh
curl -L https://ghproxy.com/https://raw.githubusercontent.com/spiritLHLS/lxc/main/scripts/backend.sh -o backend.sh && chmod +x backend.sh && bash backend.sh
```
-##### 一键安装母鸡可视化操作的面板
+## 一键安装母鸡可视化操作的面板
- (***非必须***,该面板只是为了方便可视化操作,没有也没问题)
- 原作者仓库:[跳转](https://github.com/turtle0x1/LxdMosaic)
diff --git a/docs/en_US/guide/lxd_install.md b/docs/en_US/guide/lxd_install.md
index 1e83c9c15c..77245e3b26 100644
--- a/docs/en_US/guide/lxd_install.md
+++ b/docs/en_US/guide/lxd_install.md
@@ -77,11 +77,13 @@ export PATH=$PATH:/snap/bin
## 一键安装
-:::tip
+:::warning
如果是全新的服务器,务必保证apt update和apt install curl都无问题再执行本脚本
-且自开机起最好等待5分钟后再执行以下命令,避免系统默认设置中就执行了本脚本导致apt源卡死
:::
+:::tip
+且自开机起最好等待5分钟后再执行以下命令,避免系统默认设置中就执行了本脚本导致apt源卡死
+:::
- 环境要求:Ubuntu 18+(推荐),Debian 8+(仅限x86_64架构)
**如果是Debian系的宿主机,务必在screen中执行本脚本,避免长期运行时SSH中断导致ZFS编译安装失败**
diff --git a/docs/en_US/guide/lxd_lxc.md b/docs/en_US/guide/lxd_lxc.md
index 2e246aa7f3..961bea7498 100644
--- a/docs/en_US/guide/lxd_lxc.md
+++ b/docs/en_US/guide/lxd_lxc.md
@@ -1,4 +1,6 @@
-## 普通的批量版本
+# LXC虚拟化
+
+## 普通版本批量生成
开出的小鸡配置:
@@ -32,7 +34,7 @@ curl -L https://ghproxy.com/https://raw.githubusercontent.com/spiritLHLS/lxc/mai
有时候init.sh的运行路径有问题,此时建议前面加上sudo强制根目录执行
-### 只有一个SSH端口的版本
+## 纯SSH端口版本批量生成
开出的小鸡配置:
@@ -66,6 +68,27 @@ curl -L https://ghproxy.com/https://raw.githubusercontent.com/spiritLHLS/lxc/mai
有时候least.sh的运行路径有问题,此时建议前面加上sudo强制根目录执行
+## 自定义版本批量生成
+
+- 可自定义内存和硬盘大小
+- 有执行过上面的手动批量生成过也没问题,配置是继承的不覆盖
+
+如果需要多次批量生成小鸡,可使用
+
+国际
+
+```
+curl -L https://github.com/spiritLHLS/lxc/raw/main/scripts/add_more.sh -o add_more.sh && chmod +x add_more.sh && bash add_more.sh
+```
+
+国内
+
+```shell
+curl -L https://ghproxy.com/https://github.com/spiritLHLS/lxc/raw/main/scripts/add_more.sh -o add_more.sh && chmod +x add_more.sh && bash add_more.sh
+```
+
+可多次运行批量生成小鸡,且继承前面已生成的部分在后面添加,可自定义内存和硬盘大小
+
## 查看已批量开设的信息
开完小鸡后,具体信息会生成在当前目录下的log文件中,格式如下
@@ -81,9 +104,9 @@ curl -L https://ghproxy.com/https://raw.githubusercontent.com/spiritLHLS/lxc/mai
cat log
```
-::warning
+:::warning
不要拿该脚本开出的小鸡当生产环境,LXC虚拟化不支持换内核,dd,开启bbr等操作
-::
+:::
## 部分常用LXD命令
@@ -142,15 +165,11 @@ sudo find /tmp -type f -delete
sudo find /var/cache/apt/archives -type f -delete
```
-## 一键脚本老手推荐方便快捷
+## 单独生成一个NAT服务器
- 只生成一个NAT服务器,可自定义限制所有内容
-### 只开一个NAT服务器
-
-#### 下载开机脚本
-
-- (***非必须***,如果你使用过一键安装LXD的命令,自动已下载对应的开机脚本,不用下载该脚本)
+下载开机脚本是***非必须***的,如果你使用过一键安装LXD的命令,自动已下载对应的开机脚本,不用下载该脚本
国际
@@ -164,7 +183,7 @@ curl -L https://ghproxy.com/https://raw.githubusercontent.com/spiritLHLS/lxc/mai
curl -L https://ghproxy.com/https://ghproxy.com/https://raw.githubusercontent.com/spiritLHLS/lxc/main/scripts/buildone.sh -o buildone.sh && chmod +x buildone.sh && dos2unix buildone.sh
```
-##### 开NAT服务器
+### 使用方法
内存大小以MB计算,硬盘大小以GB计算,下载速度上传速度以Mbit计算,是否启用IPV6不一定要填Y或者N,没有这个参数也行
@@ -182,7 +201,9 @@ curl -L https://ghproxy.com/https://ghproxy.com/https://raw.githubusercontent.co
./buildone.sh test 256 2 20001 20002 20025 300 300 N
```
-* 以下为开设的示例小鸡的信息:
+* 以下为开设的示例小鸡的信息:
+
+```
`小鸡名字` - test
`SSH登录的用户名` - root
`SSH登录的密码` - 随机生成
@@ -194,6 +215,7 @@ curl -L https://ghproxy.com/https://ghproxy.com/https://raw.githubusercontent.co
`下载带宽` - 300Mbit
`自动设置外网IPV6地址` - N
`系统` - debian11
+```
需要查看信息则执行
diff --git a/docs/en_US/guide/lxd_precheck.md b/docs/en_US/guide/lxd_precheck.md
index a27fb914bf..28f86738ff 100644
--- a/docs/en_US/guide/lxd_precheck.md
+++ b/docs/en_US/guide/lxd_precheck.md
@@ -1,4 +1,6 @@
-## 配置要求
+# 系统与硬件配置要求
+
+## 要求
硬件要求:
- 系统:Debian 8+, Ubuntu 18+(推荐),系统越新越好
@@ -35,6 +37,14 @@ PS: 如果硬件资源更烂,虚拟化不支持,可使用docker版本的,
**使用后续脚本的务必执行本命令检测母鸡是否符合要求**
+国际
+
```
bash <(wget -qO- --no-check-certificate https://raw.githubusercontent.com/spiritLHLS/lxc/main/scripts/pre_check.sh)
-```
\ No newline at end of file
+```
+
+国内
+
+```
+bash <(wget -qO- --no-check-certificate https://ghproxy.com/https://raw.githubusercontent.com/spiritLHLS/lxc/main/scripts/pre_check.sh)
+```
diff --git a/docs/en_US/guide/pve_install.md b/docs/en_US/guide/pve_install.md
index bf14b93a2a..0f283a1bb5 100644
--- a/docs/en_US/guide/pve_install.md
+++ b/docs/en_US/guide/pve_install.md
@@ -1,3 +1,5 @@
+# PVE主体安装
+
## 一键安装PVE
- 安装的是当下apt源最新的PVE
@@ -48,14 +50,16 @@ bash <(wget -qO- --no-check-certificate https://raw.githubusercontent.com/spirit
bash <(wget -qO- --no-check-certificate https://ghproxy.com/https://raw.githubusercontent.com/spiritLHLS/pve/main/scripts/build_backend.sh)
```
-### 自动配置宿主机的网关
+## 自动配置宿主机的网关
:::warning
使用前请保证重启过服务器且此时PVE能正常使用WEB端再执行,重启机器后不要立即执行此命令,待WEB端启动成功后至少等5分钟再执行本命令
:::
+
:::tip
这一步是最容易造成SSH断开的,原因是未等待PVE内核启动就修改网络会造成设置冲突,所以至少等几分钟待内核启动也就是WEB端启动成功后再执行
:::
+
- 创建vmbr0,母鸡允许addr和gateway为内网IP或外网IP,已自动识别
- vmbr0创建支持纯IPV4或双栈服务器,自动识别IPV4地址和IPV6地址,自动识别对应的IP区间
- 创建vmbr1(NAT网关)
diff --git a/docs/en_US/guide/pve_kvm.md b/docs/en_US/guide/pve_kvm.md
index 2c1e868065..d40ff4ef38 100644
--- a/docs/en_US/guide/pve_kvm.md
+++ b/docs/en_US/guide/pve_kvm.md
@@ -1,36 +1,34 @@
+# KVM虚拟化
+
## 部分注意事项
**执行本项目的第一个检测环境的命令**,展示如下
-
-
-
+
查询如上的只需使用下面的一键脚本自动创建虚拟机即可,无需手动再修改WEB端设置
-
-
-
+
查询如上的在使用后续脚本创建了虚拟机后,**可能**需要手动修改WEB端设置,需要关闭对应每个虚拟机的硬件嵌套虚拟化,如下图
-
-
-
+
先停止虚拟机再修改,修改完后再开机才能使用NOVNC,不关闭**可能**导致这个虚拟机有BUG无法使用
如果强行安装PVE开KVM,启动不了的也可以关闭这个选项试试能不能启动虚拟机
-### 单独开设KVM虚拟化的VM
+## 单独开设KVM虚拟化的VM
- 自动开设NAT服务器,默认使用Debian10镜像,因为该镜像占用最小
- 可在命令中自定义需要使用的镜像,这里有给出配置好的镜像,镜像自带空间设置是2~10G硬盘,日常使用**至少10G以上**即可,除非某些镜像开不起来再增加硬盘大小
- 可在命令中指定存储盘位置,默认不指定时为local盘即系统盘,可指定为PVE中显示的挂载盘
- 自定义内存大小推荐512MB内存
+
:::tip
需要注意的是宿主机内存记得开点swap免得机器炸了[开SWAP点我跳转](https://github.com/spiritLHLS/addswap)
:::
+
- 自动进行内外网端口映射,含22,80,443端口以及其他25个内外网端口号一样的端口
- 生成后需要等待一段时间虚拟机内部的cloud-init配置好网络以及登陆信息,大概需要5分钟
- 虚拟机的相关信息将会存储到WEB端对应VM的NOTES中,可在WEB端查看
@@ -47,9 +45,10 @@ curl -L https://raw.githubusercontent.com/spiritLHLS/pve/main/scripts/buildvm.sh
curl -L https://ghproxy.com/https://raw.githubusercontent.com/spiritLHLS/pve/main/scripts/buildvm.sh -o buildvm.sh && chmod +x buildvm.sh
```
-#### 使用方法
+### 使用方法
- 系统支持:详见 [跳转](https://github.com/spiritLHLS/Images/releases/tag/v1.0) 中列出的系统,使用时只需写文件名字,不需要.qcow2尾缀
+
:::tip
注意这里的用户名不能是纯数字,会造成cloudinit出问题,最好是纯英文或英文开头
:::
@@ -58,9 +57,11 @@ curl -L https://ghproxy.com/https://raw.githubusercontent.com/spiritLHLS/pve/mai
./buildvm.sh VMID 用户名 密码 CPU核数 内存 硬盘 SSH端口 80端口 443端口 外网端口起 外网端口止 系统 存储盘
```
-#### 测试示例
+### 测试示例
-* 以下为开设的示例VM的信息:
+* 以下为开设的示例VM的信息:
+
+```
`VMID` - 102
`SSH登录的用户名` - test1
`SSH登录的密码` - 1234567
@@ -73,6 +74,7 @@ curl -L https://ghproxy.com/https://raw.githubusercontent.com/spiritLHLS/pve/mai
`内外网映射端口一致的区间` - 50000到50025
`系统` - ubuntu20
`宿主机的存储盘` - local
+```
```shell
./buildvm.sh 102 test1 1234567 1 512 10 40001 40002 40003 50000 50025 ubuntu20 local
@@ -80,7 +82,7 @@ curl -L https://ghproxy.com/https://raw.githubusercontent.com/spiritLHLS/pve/mai
开设完毕可执行```cat vm102```查看信息,或到WEB端对应VM的NOTES中查看
-#### 删除示例
+### 删除示例
- 停止VM
- 删除VM
@@ -98,7 +100,7 @@ systemctl restart networking.service
rm -rf vm102
```
-#### 相关qcow2镜像
+## 相关qcow2镜像
- 已预安装开启cloudinit,开启SSH登陆,预设值SSH监听V4和V6的22端口,开启允许密码验证登陆,开启允许ROOT登陆
@@ -106,12 +108,16 @@ rm -rf vm102
[https://github.com/spiritLHLS/Images/releases/tag/v1.0](https://github.com/spiritLHLS/Images/releases/tag/v1.0)
-### 批量开设NAT的KVM虚拟化的VM
+## 批量开设NAT的KVM虚拟化的VM
:::warning
初次使用前需要保证当前PVE纯净且宿主机未进行过任何端口映射,否则设置冲突可能出现BUG
+:::
+
+:::tip
开设前请使用screen挂起执行,避免批量开设时间过长,SSH不稳定导致中间执行中断
:::
+
- 可多次运行批量生成VM
- 自动开设NAT服务器,选项留空默认使用debian11镜像,可自定义使用镜像名字,支持的系统名字详见上文支持的镜像列表
- 自动进行内外网端口映射,含22,80,443端口以及其他25个内外网端口号一样的端口
@@ -134,7 +140,7 @@ curl -L https://ghproxy.com/https://raw.githubusercontent.com/spiritLHLS/pve/mai
开设完毕可执行```cat vmlog```查看信息,或到WEB端对应VM的NOTES中查看
-#### 删除所有VM
+## 删除所有VM
- 删除所有VM
- 删除所有nat的端口映射
@@ -154,7 +160,7 @@ rm -rf vmlog
PVE修改VM配置前都得停机先,再修改配置,修改完再启动,免得出现配置重载错误
:::
-### 开设独立IPV4地址的VM
+## 开设独立IPV4地址的VM
:::warning
使用前需要保证当前宿主机的IP段带了至少2个IP,且有空余的IP未配置,该空余的IP未绑定宿主机
@@ -175,7 +181,7 @@ curl -L https://raw.githubusercontent.com/spiritLHLS/pve/main/scripts/buildvm_ex
curl -L https://ghproxy.com/https://raw.githubusercontent.com/spiritLHLS/pve/main/scripts/buildvm_extraip.sh -o buildvm_extraip.sh && chmod +x buildvm_extraip.sh
```
-#### 创建示例
+### 创建示例
```shell
./buildvm_extraip.sh VMID 用户名 密码 CPU核数 内存大小以MB计算 硬盘大小以GB计算 系统 存储盘
diff --git a/docs/en_US/guide/pve_lxc.md b/docs/en_US/guide/pve_lxc.md
index cc8796155c..ab8771132c 100644
--- a/docs/en_US/guide/pve_lxc.md
+++ b/docs/en_US/guide/pve_lxc.md
@@ -1,9 +1,15 @@
+# LXC虚拟化
+
## 单独开设LXC虚拟化的CT
:::warning
初次使用前需要保证当前PVE纯净且宿主机未进行过任何端口映射,否则设置冲突可能出现BUG
+:::
+
+:::tip
开设前请使用screen挂起执行,避免批量开设时间过长,SSH不稳定导致中间执行中断
:::
+
- 自动开设NAT服务器,默认使用Debian11镜像,也可自定义系统
- 自动进行内外网端口映射,含22,80,443端口以及其他25个内外网端口号一样的端口
- 生成后需要等待一段时间虚拟机内部配置好网络以及登陆信息,大概需要3分钟
@@ -38,7 +44,9 @@ curl -L https://ghproxy.com/https://raw.githubusercontent.com/spiritLHLS/pve/mai
#### 测试示例
-* 以下为开设的示例CT的信息:
+* 以下为开设的示例CT的信息:
+
+```
`VMID` - 102
`SSH登录的用户名` - root
`SSH登录的密码` - 1234567
@@ -51,6 +59,7 @@ curl -L https://ghproxy.com/https://raw.githubusercontent.com/spiritLHLS/pve/mai
`内外网映射端口一致的区间` - 30000到30025
`系统` - debian11
`宿主机的存储盘` - local
+```
```shell
./buildct.sh 102 1234567 1 512 5 20001 20002 20003 30000 30025 debian11 local
@@ -80,8 +89,12 @@ systemctl restart networking.service
:::warning
初次使用前需要保证当前PVE纯净且宿主机未进行过任何端口映射,否则设置冲突可能出现BUG
+:::
+
+:::tip
开设前请使用screen挂起执行,避免批量开设时间过长,SSH不稳定导致中间执行中断
:::
+
- 可多次运行批量生成CT容器,但需要注意的是母鸡内存记得开点swap免得机器炸了[开SWAP点我跳转](https://github.com/spiritLHLS/addswap)
- 每个容器创建之间有间隔等待60秒避免突发性能不足
- 可自定义批量开设的核心数,内存大小,硬盘大小,使用宿主机哪个存储盘,记得自己计算好空闲资源开设
diff --git a/docs/en_US/guide/pve_precheck.md b/docs/en_US/guide/pve_precheck.md
index 36d7abeb39..ca278a1ca7 100644
--- a/docs/en_US/guide/pve_precheck.md
+++ b/docs/en_US/guide/pve_precheck.md
@@ -1,4 +1,4 @@
-# 系统要求与配置
+# 系统和硬件配置要求
## 各种要求
@@ -8,14 +8,18 @@
本项目只适配Debian系统(非Debian无法通过APT源安装,官方只给了Debian的镜像,其他系统只能使用ISO安装)
-- 系统要求:Debian 8+
-::tip
+- 系统要求:Debian 8+
+
+:::tip
建议debian11而不是debian12,因为后者是beta版本,debian11安装的才是稳定版
-::
+:::
+
- 硬件要求:2核2G内存x86_64架构服务器硬盘至少20G
-::warning
+
+:::warning
内存开点swap免得机器炸了[开SWAP点我跳转](https://github.com/spiritLHLS/addswap)
-::
+:::
+
- 可开KVM的硬件要求:VM-X或AMD-V支持 (部分VPS和全部独服支持)
- 如果硬件或系统需求不满足,可使用LXD批量开LXC容器[跳转](https://github.com/spiritLHLS/lxc)
@@ -39,4 +43,8 @@ bash <(wget -qO- --no-check-certificate https://raw.githubusercontent.com/spirit
```
bash <(wget -qO- --no-check-certificate https://ghproxy.com/https://raw.githubusercontent.com/spiritLHLS/pve/main/scripts/check_kernal.sh)
-```
\ No newline at end of file
+```
+
+
+
+