---
source: "https://weapp.eteams.cn/build/techdoc/wdoc/index.html#/public/doc/87afb994-5eb0-4ecb-a5cd-b7de22936bf2"
publicId: "87afb994-5eb0-4ecb-a5cd-b7de22936bf2"
---

# 文件服务宝典

# 一. 功能开发能力

## 1.1、[文件服务 HTTP 相关接口](https://weapp.eteams.cn/build/techdoc/wdoc/index.html#/public/doc/d37c5a97-2309-4813-b358-6fb1bc52a594)

说明：

（1）提供文件服务前端相关的接口。

（2）只适用于内部功能开发，不能提供给二开和第三方集成使用

## 1.2、[文件服务SDK 能力](https://weapp.eteams.cn/build/techdoc/wdoc/index.html#/public/doc/cd16e1dc-75be-4848-88ae-092fe1d0f8ee)

 说明：

 （1）提供在后端进行上传，下载，以及文件处理等API

 （2）可以提供给内部人员，二开等集成使用

## 1.3、[文件服务 RPC 接口能力](https://weapp.eteams.cn/build/techdoc/wdoc/index.html#/public/doc/07d32f63-779d-4b3a-89b1-5c08ed3b0876)

 说明：

 （1）提供在后端获取文件相关信息的 RPC 接口

 （2）可以提供给内部人员，二开等集成使用

## 1.4、[文件openapi 能力](https://weapp.eteams.cn/build/techdoc/wdoc/index.html#/public/doc/a7544bb0-3c9d-48ac-af57-f55e6b75a995)

说明：

 （1）主要提供给第三方获取文件相关信息，和上传文件、下载文件

 （2）官方文档可以访问 【客户E10地址/sp/opendoc】 然后具体的接口查看具体的地址

## 1.5、文件服务二开能力

说明：

 （1）主要提供给二开服务进行二次开发

** 开发类型：**

1、[文件预览编辑服务二开埋点](https://weapp.eteams.cn/build/techdoc/wdoc/index.html#/public/doc/f1fc8876-2a61-4338-b4a7-71d8a9ea00fd)

2、[文件服务后端二开埋点](https://weapp.eteams.cn/build/techdoc/wdoc/index.html#/public/doc/51b80439-95bf-44bd-ae6e-bd4256d748e8)

3、[自定义存储二开](https://weapp.eteams.cn/build/techdoc/wdoc/index.html#/public/doc/f6e6976e-0a02-44a3-b907-ee90c1295c6d)

4、[文档比对后端二开](https://weapp.eteams.cn/build/techdoc/wdoc/index.html#/public/doc/06d57a05-ae69-48c7-b6c2-f37ffbc7df92)

# 二、文件存储说明

## 2.1、[文件存储目录架构和文件清理说明](https://weapp.eteams.cn/build/techdoc/wdoc/index.html#/public/doc/86b06827-f5fd-45b4-9eb0-c0f30a2fdb2f)

## 2.2、[支持的存储类型以及存储方案推荐](https://weapp.eteams.cn/build/techdoc/wdoc/index.html#/public/doc/6583be08-7fe7-46f9-8b2d-a8add1613bba)

## 2.3、[文件存储设置](https://weapp.eteams.cn/build/techdoc/wdoc/index.html#/public/doc/a84e45f1-834a-45ad-b96f-3e9d92d1c409)

# 三、文件迁移说明

## 3.1、OA系统升级，如：E8/E9 升级到E10

 说明：

此场景请直接咨询版本升级组

## 3.2、[E10 迁移 E10](https://weapp.eteams.cn/build/techdoc/wdoc/index.html#/public/doc/9fd676a8-d529-40a4-8022-0d68cf203313)

 适用场景说明：

 （1）将测试环境的数据迁移到生产环境

 （2）克隆了一套新的环境，需要将旧环境的数据迁移到新环境

 （3）系统切换新的存储，旧存储需要卸载，比如更新存储路径，将本地存储的数据迁移到云存储等

## 3.3、[外部数据迁移到E10](https://weapp.eteams.cn/build/techdoc/wdoc/index.html#/public/doc/9304010e-b3bf-4199-86b3-639d2a7f8694)

 适用场景说明：

（1）将第三方系统的文件数据整体迁移到 E10 中，并和相关的业务做关联

（2）采集第三方的文件数据，同步到E10中，存在知识管理模块中

## 3.4、一些常见的迁移案例

- [将历史文件迁移到FASTDFS存储中操作案例](https://weapp.eteams.cn/build/techdoc/wdoc/index.html#/public/doc/185949c7-22c3-439c-8518-26b9658dc9f9)

# 四、文件功能相关咨询问题

## 4.1、[文件服务常用设置项](https://weapp.eteams.cn/build/techdoc/wdoc/index.html#/public/doc/95b9628d-c4f7-4958-8a46-8064c40125a8)

**包含如下的设置： **

- 如何调整系统文件上传大小（第1章）
- 如何关闭附件预览页面上的操作按钮（第2章）
- 如何关闭附件列表上的电子签按钮（第3章）
- 如何修改文件下载和预览的模式变为直流输出（第5章）

## 4.2、[附件深度清理-删除按钮-如何开通](https://weapp.eteams.cn/build/techdoc/wdoc/index.html#/public/doc/b077de55-dfa4-446f-b820-722b919181d6)

## 4.3、[如何恢复被删除的文件](https://weapp.eteams.cn/build/techdoc/wdoc/index.html#/public/doc/607fefec-8b7b-43ad-aa2a-a34415737b4c)

## 4.4、[文件服务权限规则是怎么样的，要如何对接](https://weapp.eteams.cn/build/techdoc/wdoc/index.html#/public/doc/621ea340-1914-4184-b05a-b09fe49ea9ed)

## 4.5、[如何给第三方提供下载链接](https://weapp.eteams.cn/build/techdoc/wdoc/index.html#/public/doc/0c7e486f-e202-4e76-8b15-01f0e1108963)

## 4.6、[文件安全相关配置有哪些，如何开启](https://weapp.eteams.cn/build/techdoc/wdoc/index.html#/public/doc/bd04c742-351a-4611-98b2-5007d5a4433b)

## 4.7、 [E10 文件第三方加解密插件开启&对接说明](https://weapp.eteams.cn/build/techdoc/wdoc/index.html#/public/doc/11d56ec6-b2ed-4aed-b3f5-651812c1586d)

## 4.8、[文件相关数据库表说明](https://weapp.eteams.cn/build/techdoc/wdoc/index.html#/public/doc/9dadc9db-4743-4253-be7d-fdd38e5b1597)

## 4.9、[如何修改文件异常信息是否输出的配置](https://weapp.eteams.cn/build/techdoc/wdoc/index.html#/public/doc/24109d4e-a015-46c6-ba88-3acd001a390c)

 说明：

（1）、主要控制文件接口出现异常时，不返回文件的异常信息堆栈

（2）、若需要排查问题可以临时开启，正常需要关闭

## 4.10、[如何修改文件服务的配置](https://weapp.eteams.cn/build/techdoc/wdoc/index.html#/public/doc/de3d8fe6-74fd-4a91-bbdf-a7d5ae72af75)

说明：

主要演示如何修改文件服务的配置，需要修改什么配置需要和开发确认清楚

## 4.11、[如何开启文件备份功能](https://weapp.eteams.cn/build/techdoc/wdoc/index.html#/public/doc/b82157b2-5c78-4adf-bf20-aea501115185)

## 4.12、[文件和文档的关系是怎么样的，怎么进行关联的](https://weapp.eteams.cn/build/techdoc/wdoc/index.html#/public/doc/b3fb4620-4fbc-4223-b708-56911123cd80)

## 4.13、[如何确认当前系统使用是什么存储](https://weapp.eteams.cn/build/techdoc/wdoc/index.html#/public/doc/24a71bee-02f7-4fe8-934a-c06eb6b43eac)

# 五、文件常见问题处理

## 4.1、上传功能问题

- [上传功能常见问题](https://weapp.eteams.cn/build/techdoc/wdoc/index.html#/public/doc/248b0ad1-af3c-4a40-bdd3-eb0679cb1fa6)

## 4.2、下载问题

- [下载文档超过1G后，下载中断](https://weapp.eteams.cn/build/techdoc/wdoc/index.html#/public/doc/7f1f7bc4-1614-4644-bbe4-7e4004e49196)
- [使用对象存储、出现下载跳转到对象存储链接，并且无法下载的问题](https://weapp.eteams.cn/build/techdoc/wdoc/index.html#/public/doc/75fb3c24-e917-44d1-bb00-f58efe6cc3ec)

## 4.3、预览问题

- [视频无法播放问题](https://weapp.eteams.cn/build/techdoc/wdoc/index.html#/public/doc/87abfac9-55bd-4d9c-b657-c3610209c147)
- [静态文件访问失败排查](https://weapp.eteams.cn/build/techdoc/wdoc/index.html#/public/doc/90617592-d847-4479-a0a9-bea730419761)
- [素材库图片上传后不显示问题排查](https://weapp.eteams.cn/build/techdoc/wdoc/index.html#/public/doc/77f7a8d7-ec3b-45e9-ba54-165cc676116a)
- [附件不显示或者点击显示裂图问题](https://weapp.eteams.cn/build/techdoc/wdoc/index.html#/public/doc/f62e0d6a-c7b1-45f9-959b-0756796c74ff)

## 4.4、存储问题

- [出现【您访问的文件资源不存在】问题排查](https://weapp.eteams.cn/build/techdoc/wdoc/index.html#/public/doc/e320b54e-433d-4c16-aa47-e998d02e983c)
- [磁盘没有权限问题处理](https://weapp.eteams.cn/build/techdoc/wdoc/index.html#/public/doc/f2f62f17-b27d-4658-8700-14b3ad9c4900)

## 4.5、加解密问题

- [加解密插件不生效问题](https://weapp.eteams.cn/build/techdoc/wdoc/index.html#/public/doc/194ca56f-5849-47a3-bbd8-0bb109b0302a)
- [天锐绿盾插件不生效问题定位](https://weapp.eteams.cn/build/techdoc/wdoc/index.html#/public/doc/1d8b75a8-a5c4-4f95-8168-075c231a0d73)
- [亿赛通加解密插件不生效问题定位](https://weapp.eteams.cn/build/techdoc/wdoc/index.html#/public/doc/c1564591-c349-473c-9fa0-f9e9082b9f87)

## 4.6、迁移问题

- [E9从本地存储迁移到云存储，且在云存储上是压缩或者加密的，文件下载会出现打不开的问题](https://weapp.eteams.cn/build/techdoc/wdoc/index.html#/public/doc/6d1019d9-7094-4f00-9a56-0f306650f82c)
