提交 c3fc0304 编写于 作者: crlfe's avatar crlfe 😲

update unicloud-private-env.md

上级 f70012ef
# uniCloud 软件版
# uni云开发软件版
## 产品介绍
......@@ -6,9 +6,9 @@
`uniCloud serverless版`基于云计算的`serverless`技术实现,后端逻辑代码运行在云厂商的服务器(容器)中,服务器(容器)不跟具体开发者关联绑定,会随着终端用户量的变化自动弹性增减或收缩,开发者对服务器的具体型号、配置等无感。
现实中,部分开发者因合规要求(如数据必须在公司内网),或需要对后端服务器有更强的可控性,希望uniCloud能部署在自己机房内或自己的云厂商账号下,因此,`uniCloud软件版`应运而生。
现实中,部分开发者因合规要求(如数据必须在公司内网),或需要对后端服务器有更强的可控性,希望uniCloud能部署在自己机房内或自己的云厂商账号下,因此,`uni云开发软件版`应运而生。
### uniCloud软件版有哪些特点?
### uni云开发软件版有哪些特点?
从开发工具、API、生态各维度,软件版和serverless版没有差别。开发者基于serverless版编写的uniCloud项目源码,可以平滑部署到软件版,前端uni-app代码、后端云函数、云对象等代码,均无需修改。
......@@ -21,28 +21,28 @@
而如上工作,`serverless版`均无需进行,serverless版通过`服务空间`的概念,将云函数、云存储、云数据库统一封装,开发者可一键开通所有业务,不需要额外去开通云存储及CDN,也无需去安装或购买云数据库实例。
进一步解释,uniCloud软件版实际上是一个`支持uniCloud语法的Node开发框架`
进一步解释,uni云开发软件版实际上是一个`支持uniCloud语法的Node开发框架`
你可以更具象化理解:uniCloud软件版就是`支持uniCloud语法的类Egg.js框架`
你可以更具象化理解:uni云开发软件版就是`支持uniCloud语法的类Egg.js框架`
> 和Egg.js框架差异:uniCloud软件版内置有定制版本的Node.js运行时,并且仅可在内置的定制Node.js上运行,不支持使用开发者安装的Node.js环境。
> 和Egg.js框架差异:uni云开发软件版内置有定制版本的Node.js运行时,并且仅可在内置的定制Node.js上运行,不支持使用开发者安装的Node.js环境。
uniCloud软件版,作为一个开发框架,仅负责云函数、云对象的执行,支持在云函数中连接开发者自己的对象存储和数据库。而这些对象存储和数据库,需要开发者自己去购买开通,uniCloud软件版本身没有内置。
uni云开发软件版,作为一个开发框架,仅负责云函数、云对象的执行,支持在云函数中连接开发者自己的对象存储和数据库。而这些对象存储和数据库,需要开发者自己去购买开通,uni云开发软件版本身没有内置。
存储方面,uniCloud软件版目前支持如下3种存储方案:
存储方面,uni云开发软件版目前支持如下3种存储方案:
- 本地存储:文件存储和uniCloud软件版在同一台服务器上;
- 本地存储:文件存储和uni云开发软件版在同一台服务器上;
- 阿里云OSS
- 腾讯云COS
数据库方面,uniCloud软件版仅支持`mongodb`,支持本地服务器上安装的mongodb,也支持在云厂商购买单独的mongodb实例。
数据库方面,uni云开发软件版仅支持`mongodb`,支持本地服务器上安装的mongodb,也支持在云厂商购买单独的mongodb实例。
## 安装指南
::: warning 注意
1. 为了与serverless版保持一致,软件版目前仅支持`mongo 4.0` 版本
2. uniCloud软件版内置的定制`node.js`版本为`16.20.2`
2. uni云开发软件版内置的定制`node.js`版本为`16.20.2`
:::
### 系统要求
......@@ -92,9 +92,9 @@ df -h // 查看磁盘信息
### 获取安装软件
uniCloud软件版是付费软件,根据服务器数量及应用数量进行收费。
uni云开发软件版是付费软件,根据服务器数量及应用数量进行收费。
登录uniCloud控制台,按图所示进入uniCloud软件版页面
登录uniCloud控制台,按图所示进入uni云开发软件版页面
![](https://web-ext-storage.dcloud.net.cn/unicloud/docs202406031627806.png)
......@@ -102,7 +102,7 @@ uniCloud软件版是付费软件,根据服务器数量及应用数量进行收
![](https://web-ext-storage.dcloud.net.cn/unicloud/docs202406031634663.png)
同意开通后进入uniCloud软件版集群列表
同意开通后进入uni云开发软件版集群列表
![](https://web-ext-storage.dcloud.net.cn/unicloud/docs202406031639818.png)
......@@ -114,7 +114,7 @@ uniCloud软件版是付费软件,根据服务器数量及应用数量进行收
>
> 如果业务需要分布式运行可以在同一集群下添加多台服务器实现,而不需要创建新的集群。
集群创建后,需要稍等片刻,后台会在10分钟内构建最新版本的uniCloud软件版安装包。
集群创建后,需要稍等片刻,后台会在10分钟内构建最新版本的uni云开发软件版安装包。
![](https://web-ext-storage.dcloud.net.cn/unicloud/docs202406031626507.png)
......@@ -135,25 +135,25 @@ tar -zxvf [version].tar.gz -C /uniCloud
如果您有内网部署需求(服务器不允许连接外网),可以发邮件到`bd@dcloud.io`,通过商务采购方式申请开通离线集群进行部署安装使用。
### 注册 uniCloud软件版
### 注册 uni云开发软件版
uniCloud软件版安装完成后,需要像DCloud注册您的uniCloud软件版,注册成功后才可以正常运行。
uni云开发软件版安装完成后,需要像DCloud注册您的uni云开发软件版,注册成功后才可以正常运行。
每个账号每年(自然年)可以有5次注册试用版机会,单次试用时长为14天。
在试用版中可以体验完整的uniCloud软件版服务,并且不限制应用数量。
试用到期后如uniCloud软件版还在运行,接收到请求后将统一返回试用过期信息,请勿将试用版用于生产环境。
在试用版中可以体验完整的uni云开发软件版服务,并且不限制应用数量。
试用到期后如uni云开发软件版还在运行,接收到请求后将统一返回试用过期信息,请勿将试用版用于生产环境。
如需生产环境部署,请购买uniCloud软件版服务器授权。
如需生产环境部署,请购买uni云开发软件版服务器授权。
在uniCloud软件版安装目录下运行以下命令进行激活
在uni云开发软件版安装目录下运行以下命令进行激活
- `./unicloud register` 注册uniCloud软件版
- `./unicloud regsiter --trial` 注册试用uniCloud软件版
- `./unicloud register` 注册uni云开发软件版
- `./unicloud regsiter --trial` 注册试用uni云开发软件版
**离线集群uniCloud软件版注册方式**
**离线集群uni云开发软件版注册方式**
由于离线uniCloud软件版没有网络连接,需要在uniCloud软件版安装目录下运行 `./uniCloud scan` 命令,会检测服务器环境信息及注册状态,如未注册状态,会在最后生成一个硬件ID
由于离线uni云开发软件版没有网络连接,需要在uni云开发软件版安装目录下运行 `./uniCloud scan` 命令,会检测服务器环境信息及注册状态,如未注册状态,会在最后生成一个硬件ID
![](https://web-ext-storage.dcloud.net.cn/unicloud/docs202406031715273.png)
......@@ -161,34 +161,34 @@ uniCloud软件版安装完成后,需要像DCloud注册您的uniCloud软件版
![](https://web-ext-storage.dcloud.net.cn/unicloud/docs202406031924263.png)
将下载的授权文件上传uniCloud软件版安装根目录下,并重命名为`LICENSE`,即可完成注册。
将下载的授权文件上传uni云开发软件版安装根目录下,并重命名为`LICENSE`,即可完成注册。
### 添加应用授权
应用授权即授权哪些uni-app客户端可以访问uniCloud软件版,应用授权需要单独购买,
未授权的应用访问uniCloud软件版将会返回`403`错误码。
应用授权即授权哪些uni-app客户端可以访问uni云开发软件版,应用授权需要单独购买,
未授权的应用访问uni云开发软件版将会返回`403`错误码。
添加应用授权有两种方式,一种是在购买授权时,同时绑定应用,另外一种是只购买授权次数,在之后再绑定应用,根据实际情况选择。
添加完应用之后需要重新启动uniCloud软件版服务后生效。
添加完应用之后需要重新启动uni云开发软件版服务后生效。
**离线集群uniCloud软件版更新应用授权**
**离线集群uni云开发软件版更新应用授权**
在添加应用之后,点击对应的AppId的下载授权按钮,将会生成`[AppId].LICENSE`文件并下载。
![](https://web-ext-storage.dcloud.net.cn/unicloud/docs202406031923255.png)
如果是首次添加应用,请检查uniCloud软件版安装根目录下是否存在`app-license`文件夹,如不存在,请先创建。
如果是首次添加应用,请检查uni云开发软件版安装根目录下是否存在`app-license`文件夹,如不存在,请先创建。
将下载的授权文件上传uniCloud软件版安装根目录`app-license`文件夹内即可。
将下载的授权文件上传uni云开发软件版安装根目录`app-license`文件夹内即可。
添加完应用之后需要重新启动uniCloud软件版服务后生效。
添加完应用之后需要重新启动uni云开发软件版服务后生效。
### uniCloud软件版操作命令
### uni云开发软件版操作命令
> 所有命令请在软件版环境根目录运行
注册uniCloud软件版
注册uni云开发软件版
```
./unicloud register // 注册
......@@ -221,11 +221,11 @@ uniCloud软件版安装完成后,需要像DCloud注册您的uniCloud软件版
为了和serverless版保持一致的开发体验,你需要创建服务空间:
登录[uniCloud控制台](https://unicloud.dcloud.net.cn/) 新建服务空间,版本选择 uniCloud软件版,绑定集群后即可开通。
登录[uniCloud控制台](https://unicloud.dcloud.net.cn/) 新建服务空间,版本选择 uni云开发软件版,绑定集群后即可开通。
![](https://web-ext-storage.dcloud.net.cn/unicloud/docs202406031939942.png)
服务空间创建成功后,复制服务空间ID,在uniCloud软件版根目录按照以下命令创建服务空间目录
服务空间创建成功后,复制服务空间ID,在uni云开发软件版根目录按照以下命令创建服务空间目录
```
mkdir spaces // 如果spaces目录不存在先创建
......@@ -240,7 +240,7 @@ mkdir [SpaceId]
```json
//下方为配置示例,如拷贝此内容切记去除注释
{
"default": true, //是否为默认服务空间,一套uniCloud软件版环境下,只能有一个默认服务空间
"default": true, //是否为默认服务空间,一套uni云开发软件版环境下,只能有一个默认服务空间
"spaceId": "pvt-xxx",//DCloud服务空间编号,可在uniCloud控制台查看
"startAsDaemon": true, // 是否在后台运行; 默认 true
"port": 7001, //端口号,可自定义,同一台服务器下,各服务空间的端口号不可重复
......@@ -261,7 +261,7 @@ mkdir [SpaceId]
"storageSecret": "xxxxxxxxxx",//本地存储服务访问密钥
},
"logger": { //日志服务配置
"customLogDir": "/private-cloud-env/logs" //uniCloud软件版环境日志存储路径
"customLogDir": "/private-cloud-env/logs" //uni云开发软件版环境日志存储路径
},
"redis": {//redis库配置,如项目未使用redis服务可不配置此项
"host": "127.0.0.1",//redis连接
......@@ -291,11 +291,11 @@ mkdir [SpaceId]
### 使用HBuilerX开发调试
#### 安装uniCloud软件版插件
#### 安装uni云开发软件版插件
在插件市场中下载[uniCloud软件版插件](https://ext.dcloud.net.cn/plugin?id=18520),并在HBuilderX中安装。
在插件市场中下载[uni云开发软件版插件](https://ext.dcloud.net.cn/plugin?id=18520),并在HBuilderX中安装。
uniCloud软件版插件支持以下功能:
uni云开发软件版插件支持以下功能:
- 创建本地调试配置文件
- 创建本地存储调试配置文件
......@@ -305,7 +305,7 @@ uniCloud软件版插件支持以下功能:
> HBuilderX > 4.19 (暂定)
uniCloud软件版服务空间使用 `dcloud` 标识
uni云开发软件版服务空间使用 `dcloud` 标识
如果项目内不存在`dcloud`服务空间,请在项目根目录右键-创建uniCloud环境,选择 `DCloud`创建即可。
......@@ -362,13 +362,13 @@ uniCloud软件版服务空间使用 `dcloud` 标识
由于有uni_modules插件内包含uniCloud云函数等,需要进行uniCloud打包操作,将uni_modules插件内的云函数及数据库schema抽离出来。
`uniCloud-dcloud`目录右键“uniCloud软件版”-“打包uniCloud资源”,将会在`uniCloud-dcloud`服务空间目录下生成`dist`目录。
`uniCloud-dcloud`目录右键“uni云开发软件版”-“打包uniCloud资源”,将会在`uniCloud-dcloud`服务空间目录下生成`dist`目录。
可以使用git/svn等版本管理工具进行管理,将代码上传至git/svn,在服务器拉取代码,在服务器上将`uniCloud-dcloud/dist`同步到对应服务空间目录下即可。
也可以单独对`dist`目录打包zip并上传到服务器对应的服务空间目录下解压即可。
上传代码之后需要重新启动服务空间,在uniCloud软件版根目录执行以下命令进行重启操作
上传代码之后需要重新启动服务空间,在uni云开发软件版根目录执行以下命令进行重启操作
```
./unicloud stop -s [服务空间ID]
......@@ -422,7 +422,7 @@ http {
### 防火墙白名单配置
若你的服务器开启了防火墙功能,且需要访问如:`uniCloud软件版(联网版)``短信``一键登录``uni-ai``实人认证``uni-push`等在线业务,则需要将这些业务的API域名,添加到防火墙白名单中。
若你的服务器开启了防火墙功能,且需要访问如:`uni云开发软件版(联网版)``短信``一键登录``uni-ai``实人认证``uni-push`等在线业务,则需要将这些业务的API域名,添加到防火墙白名单中。
`CentOS系统`为例,配置方式如下
......@@ -440,7 +440,7 @@ sudo firewall-cmd --reload
#### 各业务API域名
- uniCloud软件版(联网版)及付费业务API域名
- uni云开发软件版(联网版)及付费业务API域名
- - pucoa1.dcloud.net.cn
- - pucoa2.dcloud.net.cn
- - pucoabk.dcloud.net.cn
......
Markdown is supported
0% .
You are about to add 0 people to the discussion. Proceed with caution.
先完成此消息的编辑!
想要评论请 注册