# rawa-examples

**Repository Path**: RAWA/rawa-examples

## Basic Information

- **Project Name**: rawa-examples
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2021-05-10
- **Last Updated**: 2025-09-05

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

## 单机版安装部署

## 参数配置

### 登录url配置

  - 配置登录跳转url *(可选)*
    
    ```yaml
      ### standalone/docker-compose.yaml

      # 应用网关
      rawa-gateway:
        environment:
          - APP_LOGIN-URL=http://localhost:8000/login # 将localhost替换成ip
         
    ```

### 邮箱配置

  - 配置企业邮箱，用于发送邮件
    
    ```yaml
      ### standalone/docker-compose.yaml

      # 账号服务
      rawa-account:
        environment:
          #  配置公司邮箱
          - SPRING_MAIL_HOST=smtp.exmail.qq.com
          - SPRING_MAIL_PORT=465
          - SPRING_MAIL_USERNAME=****message@9dingcloud.com
          - SPRING_MAIL_PASSWORD=**********
          - MAIL_SIGN-NAME=玖钉文档管理
         
    ```
  *需要开通smtp服务,建议使用授权码作为密码，不建议直接使用密码*

  ![Image text](./mail.png)

### 短信服务商配置

  - 配置阿里云短信服务，用于发送短信。
    
    ```yaml
      ### standalone/docker-compose.yaml

      # 账号服务
      rawa-account:
        environment:
          # 配置短信服务
          - SMS_REGION=cn-hangzhou
          - SMS_ACCESS-KEY=******
          - SMS_ACCESS-SECRET=********
          - SMS_DOMAIN=dysmsapi.aliyuncs.com
          - SMS_SIGN-NAME=玖钉文档管理
          - SMS_TEMPLATES_PHONE-CODE_TEMPLATE-CODE=SMS_211481907
          - SMS_TEMPLATES_PHONE-CODE_SIGN-NAME=玖钉文档管理
    ```
### OSS 配置

  - 配置本地oss的访问端点  `(必配项)`
    
    ```yaml
      ### standalone/docker-compose.yaml

      rawa-document:
        environment:
          - OSS_RAWA_ENDPOINT=localhost:9003/oss # 将此处的localhost改为本机对外ip地址
    ```

### 个人文档空间配置

- 配置个人文档空间大小
    
    ```yaml
      ### standalone/docker-compose.yaml

      rawa-document:
        environment:
          # 个人文档空间， 单位byte
          - APP_USER-SPACE=104857600
    ```

### 企业数限制

- 本地化部署，不希望创建过多的企业，可以限制企业的创建个数
    
    ```yaml
      ### standalone/docker-compose.yaml

      rawa-account:
        environment:
          - APP_ENT_LIMIT=1
    ```

### 钉钉登录

- 开启本地钉钉扫码登录

#### 修改配置

```yaml
  ### standalone/docker-compose.yaml

 rawa-account:
    environment:
    # 配置钉钉登录
    - DINGTALK_APP-KEY: xxxx
    - DINGTALK_APP-SECRET: xxxx
```

*运行reload*脚本使配置生效 

#### 添加回调地址

- 访问钉钉开发中心， 添加地址

```text

http://{ip}:8000/after-authorize

```

![Image text](./ding-callback.png)

### 开放端口

- 8000 : 账号中心web访问端口
- 8001 : 文档前台web访问端口
- 8002 ：文档后台web访问端口 
- 8003 : 预览web访问端口
- 8100 ：文档H5访问端口
- 9000 ：注册中心web访问端口
- 9001 ：应用监控web访问端口
- 9002 ：onlyoffice web访问端口
- 9003 : API 网关端口

## 安装

### Linux安装

```shell
  ### rawa-examples

  cd ./standalone
  sh ./install.sh
```
*等待下载安装完成...*


## 访问地址

- 文档系统访问地址: http://localhost:8001


## 运维工具

- 默认没有安装mysql、mongo、redis、rocketmq等数据访问工具，如有需要，请到`standalone`/`tools`下输入 `docker-compose up -d`进行安装 

## 集成

### 钉钉集成

#### 注册钉钉企业内部应用

- 打开钉钉开发者中心 [https://open-dev.dingtalk.com/#/](https://open-dev.dingtalk.com/#/)。

- 创建一个企业内部应用。
![Image text](./ding-app-create.png)

- 获取AppKey与AppSecret。
![Image text](./ding-basic-info.png)
#### 开放api权限

- 开放获取token权限。
![Image text](./ding-acl-sns.png)

- 开放通讯录权限。
![Image text](./ding-acl-contact.png)


### 企业微信


#### 免登录

- 配置主页地址

- 配置可信域名

可以参照[企业微信文档](https://developer.work.weixin.qq.com/document/path/91120)

```js

https://open.weixin.qq.com/connect/oauth2/authorize?appid=xxxx&redirect_uri=http://dev.rawacloud.com:60000/wecom-oauth&response_type=code&scope=snsapi_base&agentid=xxxx&state=1#wechat_redirect

```

## 集群版安装部署

- 待补充...