# ranuts-document

**Repository Path**: firfe/ranuts-document

## Basic Information

- **Project Name**: ranuts-document
- **Description**: 网页 Office
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-11-27
- **Last Updated**: 2025-11-27

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 网页 Office

- 原项目地址
  - 官网 https://ranuts.github.io/document/
  - GitHub仓库 https://github.com/ranuts/document
- 我汉化和构建docker镜像的仓库
  - GitHub仓库 https://github.com/Firfr/ranuts-document
  - Gitee仓库 https://gitee.com/firfe/ranuts-document
  - DockerHub https://hub.docker.com/r/firfe/ranuts-document

## 汉化&修改&镜像制作

如果镜像拉取失败，请B站发私信，或提issues，  
华为云上的镜像仓库默认推送的镜像不是公开的，有可能是我忘记设置公开了。

当前制作镜像版本(或截止更新日期)：2025.11.12

首先感谢原作者的开源。  
原项目提供的docker镜像我没有拉取到，因此制作了docker镜像和简单汉化。并更换了基础镜像，支持通过环境变量配置更多参数。



只做了汉化和简单修改，有问题，请到原作者仓库处反馈。

欢迎关注我B站账号 [秦曱凧](https://space.bilibili.com/17547201) (读作 qín yuē zhēng)  

有需要帮忙部署这个项目的朋友,一杯奶茶,即可程远程帮你部署，需要可联系。  
微信号 `E-0_0-`  
闲鱼搜索用户 `明月人间`  
或者邮箱 `firfe163@163.com`  
如果这个项目有帮到你。欢迎start。也厚颜期待您的打赏。

如有其他问题，请提`issues`，或发送B站私信。

## 镜像

从阿里云或华为云镜像仓库拉取镜像，注意填写镜像标签，镜像仓库中没有`latest`标签

容器内部端口``，可通过设置环境变量`SERVER_PORT`的值来指定监听端口。

- 国内仓库
  - AMD64镜像
    ```bash
    swr.cn-north-4.myhuaweicloud.com/firfe/ranuts-document:2025.11.12
    ```
  - ARM64镜像
    ```bash
    swr.cn-north-4.myhuaweicloud.com/firfe/ranuts-document:2025.11.12-arm64
    ```
- DockerHub仓库
  - AMD64镜像
    ```bash
    firfe/ranuts-document:2025.11.12
    ```
  - ARM64镜像
    ```bash
    firfe/ranuts-document:2025.11.12-arm64
    ```

## 部署

### docker run 命令部署

```bash
docker run -d \
--name ranuts-document \
--network bridge \
--restart always \
--log-opt max-size=1m \
--log-opt max-file=1 \
-p 5162:5162 \
swr.cn-north-4.myhuaweicloud.com/firfe/ranuts-document:2025.11.12
```

### compose 文件部署 👍推荐

```yaml
#version: '3'
name: ranuts-document
services:
  ranuts-document:
    container_name: ranuts-document
    image: swr.cn-north-4.myhuaweicloud.com/firfe/ranuts-document:2025.11.12
    network_mode: bridge
    restart: always
    logging:
      options:
        max-size: 1m
        max-file: '1'
    ports:
      - 5162:5162
```

### 更多配置

镜像支持通过环境变量进一步设置运行参数。

- 设置监听端口
  - `SERVER_PORT` 监听端口
- 设置账号
  - `SERVER_BASIC_AUTH` 默认为空 （禁用）  
    格式`用户名:密码`，必须使用`BCrypt`密码哈希函数对密码进行编码。  
    获取`BCrypt`加密的结果，可在浏览器直接搜索`在线BCrypt加密`,找一个网站对密码加密。  
    把加密结果中的`$`替换成`$$`转义。
- 证书
  - 添加证书时需要把证书文件映射到容器中。
  - 启用HTTP/2与TLS支持
    - 环境变量  `SERVER_HTTP2_TLS` 默认`false`
  - 证书文件路径
    - 环境变量  `SERVER_HTTP2_TLS_CERT` 默认为空 （禁用）
  - 私钥文件路径
    - 环境变量  `SERVER_HTTP2_TLS_KEY` 默认为空 （禁用）

更多环境变量参数请查看 [https://github.com/static-web-server/static-web-server](https://github.com/static-web-server/static-web-server)

## 效果截图

![效果截图](图片/预览.jpg)