← 返回能力目录— CAPABILITY ASSET

DocuSeal 电子签名自托管服务

GitHub → 官方文档 →

项目简介

DocuSeal 是一个开源 DocuSign 替代品，核心价值是让团队可以自托管电子签名系统，自己掌控 PDF 表单、签署流程、文件存储、邮件通知和 API 集成。

PDF 表单构建器

WYSIWYG 拖拽创建签名、日期、文件、复选框等字段，官方列出 12 种字段类型

多人签署流程

一个文档可分配给多个 submitter，适合合同、HR、KYC、医疗和金融流程

邮件流转

支持 SMTP 自动发送签署邮件，配合域名、模板和送达监控形成业务闭环

多存储后端

文件可存储在本地磁盘、AWS S3、Google Storage 或 Azure Cloud，便于私有化和合规部署

签名与验证

自动生成 PDF eSignature，并支持 PDF signature verification，适合把签署证据纳入归档流程

API / Webhooks

可接入 CRM、KYC、HR、SaaS 系统，也支持嵌入式签署和表单构建器等商业能力

我们提供的服务

部署服务

签署场景梳理明确合同、KYC、HR、医疗、金融或 SaaS 嵌入场景，定义签署人、字段、通知、归档和审计要求
许可与 Pro Features 评估核对 AGPLv3 + Section 7(b) Additional Terms，确认是否涉及白标、角色、提醒、SMS、SSO/SAML、嵌入式签署等 Pro 功能
Docker / Compose 部署可用 docker run 快速启动；生产建议 Docker Compose + PostgreSQL + Caddy/HTTPS + 持久化卷
数据库与文件存储默认 SQLite 适合试用；生产建议 PostgreSQL 或 MySQL，并选择本地磁盘、S3、Google Storage 或 Azure Cloud 存储文件
SMTP 与域名配置配置 SMTP、发件域名、SPF/DKIM/DMARC、HTTPS 和品牌通知，保证签署邮件可达且可信
业务系统集成通过 API / Webhooks 对接 CRM、KYC、HR、工单或客户门户，把签署状态回写到业务系统
法律效力与审计按国家、行业和合同类型确认电子签名、身份认证、证书、时间戳、审计日志和证据留存要求

运维服务

安全与版本升级跟踪 DocuSeal release、安全修复、Rails 依赖、容器镜像和 Ruby runtime，建立灰度升级与回滚机制
备份与恢复定期备份数据库、文件存储、密钥、配置和邮件模板；演练合同 PDF 与审计记录恢复
邮件送达监控监控 SMTP 退信、垃圾箱命中、域名信誉、提醒任务和签署邀请失败率
权限与租户治理管理用户、角色、模板、API key、Webhook secret、管理员权限和离职交接流程
合规复核定期复核电子签名法律要求、隐私政策、数据留存、跨境存储、审计日志和第三方存储合规
模板质量维护维护 PDF 模板、字段位置、多签署人顺序、移动端体验和语言版本，避免业务文件变更后流程失效

GitHub 实战调研（2026-05-19）

截至 2026-05-19，GitHub API 显示 DocuSeal 约 16.7k Stars、1.5k Forks、2673 commits、100 个 open issues、20 个 open PR；AGPL-3.0 协议，主语言 Ruby。最新 release 为 3.0.0（2026-05-18），官方说明这是 DocuSeal 开发 3 周年版本，不包含 breaking changes。

DocuSeal 深度调查研究报告

一句话结论

DocuSeal 是一个开源 DocuSign 替代品，核心价值是让团队可以自托管电子签名系统，自己掌控 PDF 表单、签署流程、文件存储、邮件通知和 API 集成。

项目定位

DocuSeal 解决的是电子签名 SaaS 的三个痛点：DocuSign、Adobe Sign 等商业产品成本高；合同、KYC、HR、医疗、金融等场景对数据控制要求高；很多业务系统需要把签署流程嵌入自己的产品，而不是让用户跳到第三方平台。

所以它不是单纯 PDF 编辑器，而是一个完整的“文档填写 + 签署 + 存储 + 验证 + 集成”系统。

核心能力

  • PDF 表单构建器：WYSIWYG 拖拽创建签名、日期、文件、复选框等字段。
  • 多签署人：一个文档可分配给多个 submitter。
  • 邮件流转：支持 SMTP 自动发送签署邮件。
  • 文件存储：支持本地磁盘、AWS S3、Google Storage、Azure Cloud。
  • 电子签名：自动生成 PDF eSignature。
  • 签名验证：支持 PDF signature verification。
  • API / Webhooks：方便接入 CRM、KYC、HR、SaaS 系统。
  • 多语言与移动端：UI 7 种语言，签署流程 14 种语言，移动端优化。

技术路线

DocuSeal 主技术栈是 Ruby on Rails + Vue + Hotwire/Turbo + Tailwind。后端负责账户、模板、文档、签署流程、存储和 API；前端负责表单构建器、签署界面和管理后台。

部署上比较友好：可以用 Docker 单命令启动，默认 SQLite，也可以通过 DATABASE_URL 接 PostgreSQL 或 MySQL。Docker Compose 版本还能接域名和 HTTPS，适合中小团队自部署。

和同类产品对比

  • DocuSign：商业电子签名平台；DocuSeal 可自托管、成本更可控。
  • Adobe Acrobat Sign：企业文档签署；DocuSeal 更轻量、更适合开发者集成。
  • PandaDoc：销售文档自动化；DocuSeal 更聚焦签署流程和 PDF 表单。
  • OpenSign：开源电子签名；DocuSeal 的成熟度、stars 和部署体验更强。
  • 自研签名系统：完全可控但成本高；DocuSeal 节省大量 PDF、流程、验证开发成本。

商业模式与许可

DocuSeal 采用 AGPLv3 + Section 7(b) Additional Terms。源码开放，但不等于商业使用完全无约束。特别是 SaaS、二次分发、修改后提供网络服务，都需要认真看 AGPL 和额外条款。

另外，项目有 Pro Features，例如白标、用户角色、自动提醒、短信验证、条件字段、批量发送、SSO/SAML、嵌入式签署和表单构建器等。这说明它采用典型 open-core 模式：基础能力开源，高级企业能力商业化。

项目成熟度

截至 2026-05-19 核查，GitHub API 显示 DocuSeal 约 16.7k stars、1.5k forks、2673 commits，最新 release 是 3.0.0，发布于 2026-05-18。

从功能、部署、文档和商业化路径看，DocuSeal 已经不是早期实验项目，而是一个可以被团队认真评估的开源电子签名产品。

风险与边界

  • 电子签名涉及法律效力。不同国家、行业、合同类型对电子签名、审计日志、身份认证、证书、时间戳的要求不同，不能只看功能能不能签。
  • AGPL 和额外条款需要谨慎。尤其是想改代码、做 SaaS、集成进商业产品时，必须先看许可和商业授权。
  • 自托管意味着你要自己负责安全、备份、邮件送达、文件存储、域名 HTTPS、权限管理和合规审计。
  • 部分企业关键能力属于 Pro Features，不能默认开源版全都有。

最终判断

DocuSeal 是目前开源电子签名方向里非常值得关注的项目。它把 PDF 表单构建、多人签署、邮件流转、文件存储、签名验证、API/Webhooks 和部署体验做成了一套完整系统。

它最适合有技术能力、想控制数据和成本、需要把签署流程嵌入自己业务系统的团队。

结论：DocuSeal 不是简单 PDF 签名工具，而是一个开源电子签名基础设施。技术上成熟度很高，但真正落地前必须核清楚许可、合规和电子签名法律效力。

相关调研资料

EXTERNAL

DocuSeal GitHub 仓库

官方仓库，包含 README、Docker 部署、功能列表、Pro Features 和源码。

查看资料 →EXTERNAL

DocuSeal 官网

官方产品网站、文档、云服务、在线工具、嵌入式签署和商业功能说明。

查看资料 →EXTERNAL

Release 3.0.0

2026-05-18 最新正式版，包含长表单 Complete 按钮、number 百分比格式、默认校验错误、PDF 图片优化、安全和 bug 修复。

查看资料 →EXTERNAL

AGPLv3 License

DocuSeal 使用 AGPLv3，并在 README 中声明 Section 7(b) Additional Terms；商业和 SaaS 场景需做许可审查。

查看资料 →EXTERNAL

Additional Terms

官方额外条款文件，是评估二次分发、品牌、UI notice 和商业集成边界时必须一起看的材料。

查看资料 →

主流部署方案

中小团队自托管版

Docker Compose + PostgreSQL + Caddy HTTPS + SMTP + 本地磁盘 / S3。

适合想降低 DocuSign / Adobe Sign 成本，同时希望把合同和签署文件留在自有服务器或云账号中的团队。

  • 部署门槛低，Docker Compose 可直接接域名和 HTTPS
  • 生产建议从 SQLite 升级到 PostgreSQL
  • 适合合同、HR、采购、合作协议等常规签署流

SaaS / 业务系统嵌入版

DocuSeal API + Webhooks + Embedded signing / builder + CRM/KYC/HR backend。

适合把签署流程嵌进自有产品，让用户在业务系统里完成表单填写、签署、状态回写和文档归档。

  • API/Webhooks 让签署状态可进入业务闭环
  • 嵌入式签署和构建器属于 Pro / 商业功能，需要提前确认授权
  • 适合 KYC、客户 onboarding、供应商合同和 SaaS 产品流程

高合规行业私有化版

DocuSeal + 私有对象存储 + SSO/SAML + 审计日志 + 备份恢复 + 合规评估。

适合医疗、金融、政企、法务等数据控制要求强、审计要求高的场景。

  • 自托管便于控制数据位置和访问权限
  • 需要结合法务确认电子签名效力和证据要求
  • SSO/SAML、角色、SMS 验证等高级能力通常需要 Pro 版本

硬件建议（按负载分层）

档位CPU内存磁盘适用场景
试用 / 小团队2 vCPU4GB50GB+ SSDDocker 单机、SQLite 或小型 PostgreSQL、少量模板和低频签署。
生产标准4 vCPU8-16GB100GB+ SSD + 对象存储Docker Compose、PostgreSQL、SMTP、HTTPS、文件外置存储、定期备份。
高合规 / 高并发8+ vCPU32GB+按 PDF 留存和审计周期配置大量签署、对象存储、外部数据库、监控、审计、SSO/SAML 和灾备。

Skills 配置方案

Docker 快速部署

官方 README 给出的 Docker 和 Docker Compose 路线，适合试用和生产私有化起步。

# Quick start
docker run --name docuseal -p 3000:3000 -v .:/data docuseal/docuseal

# Docker Compose with HTTPS
curl https://raw.githubusercontent.com/docusealco/docuseal/master/docker-compose.yml > docker-compose.yml
sudo HOST=your-domain-name.com docker compose up
  • 默认 Docker 容器使用 SQLite；生产建议设置 DATABASE_URL 接 PostgreSQL 或 MySQL。
  • Docker Compose 示例使用 Caddy 自动签发 HTTPS 证书，DNS 要先指向服务器。
  • 正式上线前先配置 SMTP、备份、管理员账号和文件存储策略。

生产环境关键变量

生产落地时通常要补齐数据库、HTTPS、SMTP、文件存储和安全配置。

DATABASE_URL=postgresql://user:password@postgres:5432/docuseal
FORCE_SSL=your-domain-name.com
# SMTP / storage / app secrets should be configured per deployment policy
  • 不要把合同 PDF、签名文件和密钥只放在无备份的本地磁盘。
  • 邮件域名 SPF/DKIM/DMARC 会直接影响签署邀请送达率。
  • AGPL + Additional Terms 与电子签名法律效力都需要上线前确认。

参考仓库（实时调研）

为什么选择我们

懂电子签名业务链路

不把 DocuSeal 当 PDF 小工具，而是按模板、签署、通知、存储、审计和业务回写设计完整流程

重视许可与法律边界

上线前会同时核 AGPL、Section 7(b) Additional Terms、Pro Features 和本地电子签名法律要求

能做私有化工程落地

覆盖 Docker Compose、PostgreSQL、对象存储、SMTP、HTTPS、备份、监控和权限治理

擅长业务系统集成

通过 API / Webhooks 把签署流程接入 CRM、KYC、HR、SaaS 或客户门户，而不是停留在独立后台

— CONTACT

需要帮忙落地 DocuSeal？

我们提供专业的落地与运维服务

联系咨询 →