DocuSeal 开源 DocuSign 替代品 2026:自托管电子签名系统 Docker 部署与使用指南
发布: 2026-05-06 • 阅读: 8 分钟 • 标签: DocuSeal, DocuSign 替代, 开源, Docker, 电子签名电子签名这件事 2026 年早已不是新鲜事 但 DocuSign 每年几千刀的订阅费对很多中小团队和个人开发者来说还是太贵了
GitHub Trending 上冲出来的 DocuSeal 就是那个让你自己搭一套电子签名系统的开源方案 AGPLv3 协议 完全自托管 数据在自己手里 不用看任何人的脸色
本文手把手教你用 Docker 部署 DocuSeal 从单机跑起来到 HTTPS 域名配置再到 API 集成 看完就能上线
DocuSeal 是什么
DocuSeal 是一个开源的数字文档签名与处理平台 你可以把它理解成一个开源版的 DocuSign
它解决的问题很直接:你的用户需要在 PDF 上签字 但你不想把数据交给第三方的 SaaS 也不想每个月交几百美元的年费
核心能力一览:
- WYSIWYG PDF 表单构建器 — 拖拽式添加签名字段 日期 文件上传等 12 种字段类型
- 多人签署同一文档 — 支持多个签署人按顺序或并行签署
- 自动邮件通知 — SMTP 集成 自动发送签署邀请和提醒
- PDF 签名验证 — 签署完成后可验证签名真实性
- 批量发送 — 通过 CSV/XLSX 导入批量发送合同 适合租赁 入职等场景
- 14 种签署语言 + 7 种 UI 语言
- API + Webhooks — REST API 对接现有业务系统
- SAML/SSO — 企业级单点登录
- 存储后端可选 — 本地磁盘 AWS S3 Google Storage Azure Cloud
Docker 一键部署
最简单的上手方式是用 Docker 单容器启动 适合本地测试或轻量使用
docker run --name docuseal -p 3000:3000 -v ./data:/data docuseal/docuseal
启动后浏览器打开 http://localhost:3000 就能看到登录页面 默认使用 SQLite 存储数据
生产环境 Docker Compose 部署
生产环境建议用 Docker Compose + Caddy 自动 HTTPS 先把 compose 文件下载到服务器
curl -O https://raw.githubusercontent.com/docusealco/docuseal/master/docker-compose.yml
确保你的域名 DNS 已经解析到服务器 IP 然后一条命令启动
sudo HOST=sign.yourdomain.com docker compose up -d
Caddy 会自动申请 Let's Encrypt 证书 完成后就能通过 https://sign.yourdomain.com 访问了
环境变量配置说明
DocuSeal 支持通过环境变量进行详细配置 常用的几个:
DATABASE_URL— 生产环境建议切换 PostgreSQL 或 MySQL 替代默认的 SQLiteFORCE_SSL— 强制 HTTPS 重定向 生产环境必须开SMTP_*— SMTP 发件配置 签署邀请邮件靠这个S3_*— 如果需要将文件存到对象存储而非本地磁盘DEFAULT_MAX_REQUESTS— API 限流配置
创建第一个签名模板
部署完成后 登录后台就能开始创建签名流程了
- 点击 Create Template → 上传一份 PDF 合同文件
- 用 WYSIWYG 编辑器拖拽添加签名框 日期 勾选框等字段
- 指定签署人顺序(一个人签完自动轮到下一个)
- 设置邮件模板 触发自动发送签署邀请
- 完成后点击 Send 就可以等待签署了
签署人收到邮件后点击链接 在浏览器里就能完成签名 不需要安装任何客户端
API 集成
DocuSeal 提供了完整的 REST API 方便集成到现有业务系统中
创建签署请求:
POST /api/v1/submissions
{
"template_id": 1,
"submitters": [
{"email": "client@example.com", "role": "signer"}
]
}
查询签署状态:
GET /api/v1/submissions/{id}
还支持 Webhooks 配置 签署完成后自动回调你的后端接口 方便对接 CRM ERP 等系统
如果你需要在前端集成 官方提供了 React Vue Angular 和原生 JavaScript 的嵌入组件 可以直接把签名表单嵌到你的 Web 应用里
使用场景推荐
- 租赁合同 — 批量上传租客信息 CSV 自动生成合同并发送签署
- 员工入职 — 录用通知书 保密协议 员工手册确认 一条龙自动发送
- 客户合同 — 销售合同在线签署 签署完成自动归档并通知财务
- NDA 保密协议 — 合作前快速在线签署 不再需要打印扫描
与 DocuSign 的对比
| 功能 | DocuSeal | DocuSign |
|---|---|---|
| 价格 | 免费(自托管) | $10-40/月起步 |
| 数据控制 | 完全自主 | 第三方托管 |
| 部署 | Docker 一键 | 仅 SaaS |
| API | REST + Webhook | REST + Webhook |
| SSO/SAML | 支持 | 企业版支持 |
| 审计日志 | 内置 | 内置 |
| 签名验证 | PDF 签名验证 | 支持 |
一句话总结:如果你不需要 DocuSign 的全球合规背书(比如 HIPAA FedRAMP 等)DocuSeal 的功能对 90% 的团队来说完全够用 而且钱和时间都省了
注意事项
- 备份数据库 — SQLite 的话记得定期备份 data 目录 用 PostgreSQL 的话配置好自动备份
- HTTPS 必开 — 电子签名涉及法律效力 不加密不行
- SMTP 配置 — 确保邮件能正常送达 推荐用 SendGrid Postmark 等专业发送服务
- 法律有效性 — 中国《电子签名法》认可的可靠电子签名需要满足身份认证+签署意愿确认 DocuSeal 提供基础签名功能 涉及重大合同建议咨询法务
总结
DocuSeal 是 2026 年开源生态里非常实用的一个项目 对于需要电子签名但又不想付高价的中小团队来说 它是目前最好的自托管方案之一
GitHub 上持续保持热度 社区活跃 文档也比较完善 花十分钟跑起来 就能省下每年几千块的 SaaS 订阅费