improve

Websoft9 · Jan 17, 2024 · b632f48 · b632f48
1 parent 287f042
commit b632f48
Show file tree

Hide file tree

Showing 9 changed files with 108 additions and 41 deletions.
diff --git a/docs/install/requirements.md b/docs/install/requirements.md
@@ -16,23 +16,32 @@ Websoft9 支持在 Red Hat, CentOS, Debian, Ubuntu 等[主流 Linux 发行版](h
 
 ## 域名{#domain}
 
-虽然域名不是 Websoft9 所必须的，但我们强烈建议您为 Websoft9 准备一个域名（可以是二级域名），并为域名提供**泛解析**的方式。一次设置后，所有应用都可以通过域名访问。  
+域名不是 Websoft9 运行的必要条件，但没有域名，应用访问会造成比必要的麻烦，故建议配置域名。    
 
-域名的泛解析通过 A 记录的一种类型，它主要是以 * 替代部分或全部的主机记录。  
+Websoft9 支持**泛解析的域名**。一次设置后，所有应用均可使用。  
+
+> 泛解析通过 A 记录的一种类型，它主要是以 * 替代部分或全部的主机记录。  
 
 假设您有 abc.com 这个域名，下面是使用泛解析的几个范例：
 
-| 记录类型 | 主机记录（域名前缀） | 记录值（服务器 IP） | 结果                                                         |
+| 类型 | 主机记录（域名前缀） | 记录值（服务器 IP） | 结果                                                         |
 | -------- | -------------------- | ------------------- | ------------------------------------------------------------ |
 | A        | *                    | 47.92.175.172       | 以 abc.com 结尾的域名可用，例如：n1.abc.com, n2.abc.com ...  |
 | A        | *.test               | 47.92.175.172       | 以 test.abc.com 结尾的域名可用。例如：n1.test.abc.com, n2.test.abc.com ... |
 | A        | *.test.web           | 47.92.175.172       | 以 test.web.abc.com 结尾的域名可用。例如：n1.test.web.abc.com, n2.test.web.abc.com ... |
 
 
+## 浏览器
+
+我们在主流的浏览器中都进行了兼容性测试：
+
+- Chrome
+- Edge
+- Firefox
 
-## 硬件{#hd}
+## 服务器{#hd}
 
-### 系统
+### 云架构
 
 不管是公有云还是私有云，甚至没有使用虚拟化的服务器都可以安装 Websoft9
 

diff --git a/docs/install/setup.md b/docs/install/setup.md
@@ -13,7 +13,7 @@ import {useCurrentSidebarCategory} from '@docusaurus/theme-common';
 
 ## 登录
 
-登录 Websoft9 不需要额外的特别设置，只需要了解或准备如下几个要素：  
+登录 Websoft9 不需要额外的特别设置，只需要从本地浏览器访问服务器对应的端口即可：  
 
 - 访问地址： *http://服务器公网IP:9000*  
 - 默认密码：服务器的 root 账号与密码

diff --git a/docs/readme.md b/docs/readme.md
@@ -13,7 +13,7 @@ slug: /
 
 Websoft9 是一个创新的云原生应用商店。通过它的 Web 控制台，可以一键部署数据、AI、网站等数百个热门的开源云应用署。  
 
-对于创新型组织来说，Websoft9 消除了任何障碍。帮助擅长使用软件工具的工作者或企业，在几分钟的时间内便可以进入企业数字化和 AI 的大门。它让用户专注于工具的使用，极大提升工作效率和职业竞争力。 
+对于创新型组织来说，Websoft9 消除了任何技术障碍。帮助擅长使用软件工具的工作者或企业，在几分钟的时间内便可以进入企业数字化和 AI 的大门。它让用户专注于工具的使用，极大提升工作效率和职业竞争力。 
 
 从技术上讲， Websoft9 是一个微服务架构的 PaaS 平台，它管理软件的生命周期：寻找、部署、维护、升级和监控。它支持 Docker, K8s 等原生架构，以 Nginx 作为应用网关，为应用提供了自动化的配置域名、HTTPS 证书生成。
 

diff --git a/docs/user/apps/_category_.yml b/docs/user/apps/_category_.yml
@@ -1,2 +1,2 @@
 label: "应用管理"
-position: 2
+position: 4
diff --git a/docs/user/appstore.md b/docs/user/appstore.md
@@ -0,0 +1,28 @@
+---
+sidebar_position: 2
+slug: /user/appstore
+---
+
+# 应用商店
+
+应用商店是 Websoft9 最核心的功能之一，它通过一个友好的界面，集中显示了数百个开源软件。  
+
+同时，可以进行分类筛选，并一键安装到服务器。  
+
+## 分类
+
+提供二级分类，更好的了解各个领域的软件排名
+
+![](https://libs.websoft9.com/Websoft9/DocsPicture/zh/websoft9/websoft9-appstorefilter.png)
+
+## 搜索
+
+提供应用名称、标题和详情检索，快速找到所需的应用
+
+![](https://libs.websoft9.com/Websoft9/DocsPicture/zh/websoft9/websoft9-appstoresearch.png)
+
+## 详情
+
+应用详情中可以查看版本、系统要求
+
+![](https://libs.websoft9.com/Websoft9/DocsPicture/zh/websoft9/websoft9-appstoredetail.png)
diff --git a/docs/user/connectdb.md b/docs/user/connectdb.md
@@ -1,9 +1,9 @@
 ---
-sidebar_position: 3
+sidebar_position: 5
 slug: /user/dbgui
 ---
 
-# 可视化管理数据库
+# 数据库
 
 连接数据库除了登录服务器以命令行形式连接之外，还可以使用本地电脑客户端和预装的 Web 在线工具连接 
 

diff --git a/docs/user/credentials.mdx b/docs/user/credentials.mdx
@@ -7,47 +7,51 @@ import Tabs from '@theme/Tabs';
 import TabItem from '@theme/TabItem';
 
 
-# 获取账号密码
+# 账号
 
-Websoft9 应用所需的数据库密码以及部分应用的默认账号，已经提前预设，并存储在运行应用所在的服务器中。 
+Websoft9 控制台与 Linux 系统共享同样的账户。  
 
-## 获取
+即，理论上不管是 root 用户，还是普通用户，只要具备登录密码，都可以无障碍的登录到 Websoft9。 
 
-<Tabs>
-  <TabItem value="linux" label="Linux" default>
+![Websoft9 登录界面](https://libs.websoft9.com/Websoft9/DocsPicture/zh/websoft9/websoft9-loginpage.png)
 
-  密码存储路径： */credentials/password.txt*    
+## 设置用户
 
-  建议通过云控制台连接服务器，在命令行终端中，运行 cat 命令获取数据库密码：
+根据实际情况，对用户进行额外的设置：  
 
-  ```
-  sudo cat /credentials/password.txt
-  ```
-  ![运行cat命令](https://libs.websoft9.com/Websoft9/DocsPicture/zh/common/catdbpassword-websoft9.png)
+### root 用户
 
-   也可以使用 SFTP 工具，直接打开密码存储文件，查看密码：
-
-  ![获取数据库密码](https://libs.websoft9.com/Websoft9/DocsPicture/zh/winscp/winscp-checkpasswordfile-websoft9.png)
+如果 root 账号使用的是密钥对，需额外设置密码：  
 
+1. 使用密钥对登录 Linux
+2. 运行命令 `passwd` 为用户设置密码
 
-  </TabItem>
-  <TabItem value="windows" label="Windows">
+### 普通用户
 
-  密码存储路径：*C:\credentials\password.txt*   
+如果普通用户使用的是密钥对，需登录 Linux 后运行 `passwd` 设置密码。  
 
-   服务器的桌面上会有打开数据库密码文件的快捷方式  
+普通用户只要用于密码即可登录 Websoft9 控制台，但需进一步提升权限以方便在控制台进行各种操作。  
 
-  </TabItem>
-</Tabs>
+**任意**运行下面的提权命令**之一**，为普通用户设置权限：   
 
+```
+# 设置 Docker 权限
+usermod -aG docker yourusername
 
+# 设置 sudo 权限
+usermod -aG sudo yourusername
 
-预设的密码安全吗？  
+# 设置 管理员 权限
+  usermod -aG wheel yourusername
+```
 
-预设的密码具有唯一性，且符合加强密码的规则，相对还比较安全。
+## 新增用户
 
-## 验证
+如果以 root 身份登录到 Websoft9 控制台后，可以很方便的增加更多用户：
 
-获取账号密码之后，您可以参考下面的文档验证账号的可用性：  
+1. 打开左侧菜单工具组中的【用户账户】页面
 
-* [Web 可视化数据库管理工具](./dbgui#webgui)
+2. 点击【创建新账号】，根据引导创建一个用户
+
+3. 再次对新创建的用户进行编辑，用户组项中选中 **docker** 即可
+   ![赋予 docker 组权限](https://libs.websoft9.com/Websoft9/DocsPicture/zh/websoft9/websoft9-addgroupdocker.png)
diff --git a/docs/user/installapp.md b/docs/user/installapp.md
@@ -0,0 +1,32 @@
+---
+sidebar_position: 3
+slug: /user/installapp
+---
+
+# 安装应用
+
+安装应用是 Websoft9 最吸引用户的功能之一，它与很多同类软件有很多之处：
+
+- 遵循“先安装，再配置”的原则，努力消除了一切困扰用户的安装参数
+- 根据已经绑定的泛解析，自动为每个应用应用绑定域名
+- 兼容**域名和端口**两种常见的应用访问模式
+- 应用的配置文件和数据文件分离
+- 基于 GitOps 的技术哲学，让应用可以持续部署
+
+
+下面是一个安装应用的范例：  
+
+1. 进入应用商店，打开应用详情后点击【安装】
+
+   ![](https://libs.websoft9.com/Websoft9/DocsPicture/zh/websoft9/websoft9-appstoredetail.png)
+
+2. 填写或选择所需的参数：
+
+   - 应用名称：建议填写为可识别的英文或拼音
+   - 版本：自行选择，其中 latest 版本不是严格每日测试的版本
+   - 端口：外网访问端口，设置后需要同时在安全组中放开方可使用
+   - 域名：自动产生的域名或自行额外增加域名，也可以禁用自动产生的域名
+
+   ![](https://libs.websoft9.com/Websoft9/DocsPicture/zh/websoft9/websoft9-installapp-fill.png)
+
+   > 在使用域名的情况下，外围端口设置后不需要在安全组中设置。  
diff --git a/docs/user/monitor.md b/docs/user/monitor.md