夜雨聆风前言
做过企业应用的人应该都有过这种体验：合同走线上签约，要么接 DocuSign 这类 SaaS，按签名次数收费，量一大费用扛不住；要么自己造轮子，PDF 签名、表单填写、多角色流转、邮-件通知，一套下来开发周期按月算。
GitHub 上有一批开源项目试图处理这个问题，但大部分要么功能不完整，要么部署太重，要么 API 设计粗糙，很难真正用到生产环境。我在筛电子签名相关的开源方案时翻到了 DocuSeal，使用之后感觉它的完成度比较高，分享一下。
特点一览
DocuSeal 是一个开源的数字文档签约平台，定位是 DocuSign、PandaDoc 的开源替代。在 GitHub 上拿了 13k+ Star，目前在 Trending 榜上也有不错的热度。
核心功能：
• PDF 表单可视化编辑器：所见即所得，拖拽式操作，12 种字段类型（签名、日期、文件上传、复选框等） • 多角色签署：一份文档支持多个签署人，按角色分配不同字段 • 自动邮-件通知：通过 SMTP 发送签署邀请、完成通知、逾期提醒 • 文件存储灵活：支持本地磁盘、AWS S3、Google Cloud Storage、Azure Blob • 白标定制：可替换公司 Logo、自定义品牌色，嵌入自己的系统 • API 和 Webhook：RESTful API 覆盖模板管理、签署请求、文档获取全流程 • 前端组件嵌入：提供 React、Vue、Angular、原生 JS 四种嵌入方案 • 批量发送：导入 CSV/XLSX 批量生成签署请求 • 条件字段和公式：表单支持条件显示和自动计算 • SSO/SAML 集成：企业级身份认证 • SMS 身份验证：签署前短信验证身份
和同类项目对比
对比下来，DocuSeal 在功能覆盖度和部署便捷性上平衡得不错。API 文档也写得很清晰，这一点对开发者很友好。
技术架构
DocuSeal 的后端主要用 Ruby on Rails 构建，前端用的是 JavaScript。数据库方面默认 SQLite，可以切换 PostgreSQL 或 MySQL。
技术栈不算花哨，但选型很务实。Ruby on Rails 在文件处理和 API 开发上效率很高，这也是为什么它能快速覆盖那么多功能的原因之一。
几个值得注意的技术点：
• 模板引擎支持 HTML API：你可以用纯 HTML 定义文档模板，通过 API 动态生成 PDF 表单。对于需要程序化生成合同模板的场景很实用 • PDF 签名验证：生成的签名 PDF 自带数字签名，可验证文档是否被篡改 • Embedded 组件：嵌入方案的实现思路是提供一个 iframe 式的签名表单，通过 JWT 鉴权。你的前端只需要引入一段 JS 代码，就能在自己的页面里完成整个签署流程
部署方式
部署门槛比较低，Docker 一行命令就能跑起来：
docker run --name docuseal -p 3000:3000 -v .:/data docuseal/docuseal如果需要自定义域名 + HTTPS，用 Docker Compose + Caddy 自动签证书：
curl https://raw.githubusercontent.com/docusealco/docuseal/master/docker-compose.yml > docker-compose.ymlsudo HOST=your-domain-name.com docker compose up也支持一键部署到 Heroku、Railway、DigitalOcean、Render 这些平台。
开源协议
DocuSeal 采用 AGPLv3 协议，附加了 Section 7(b) 条款。
AGPLv3 意味着如果你修改了源码并作为网络服务提供给第三方，需要公开修改后的源码。对于直接拿来内部使用或者部署私有服务的场景，这个协议没有限制。
不过作为研究学习还是比较适合的，看看人家采用了什么方式可以做到签章，自动落章之类的，毕竟国内开源有，但是可供选择也比较少。
即刻体验一波
场景一：合同签署流程
上传一份 PDF 合同，在编辑器里拖出签署区、日期栏、姓名栏。指定甲方和乙方两个角色，甲方填基本信息和盖章，乙方只填签名和日期。保存为模板后，输入双方邮箱发送签署邀请，对方收到邮-件点击链接就能在手机上完成签署。全程不需要对方安装任何软件。
场景三：嵌入自有系统
假设你有一个 SaaS 产品，需要在用户注册完成后让用户签署服务协议。用 DocuSeal 的嵌入式组件，在注册流程的最后一步嵌入一个签名表单，用户签完后通过 Webhook 回调你的系统更新状态。React、Vue、Angular 都有现成的组件包，集成成本很低。
场景三：批量发送签署请求
公司有 200 个供应商需要签署年度框架协议。准备好合同 PDF 和包含供应商信息的 Excel 表，导入后批量生成签署请求，系统自动按行发送邮-件。谁签了谁没签，在后台一目了然。
适合谁用
• 如果你正在做一个需要电子签约功能的 SaaS 产品，不想按次付费给第三方，DocuSeal 值得认真评估 • 如果你的团队内部经常需要走线上审批和签署流程，部署一套 DocuSeal 作为内部工具成本很低 • 如果你是独立开发者，产品里需要签名功能，嵌入组件 + API 的组合方式很适合快速集成 • 如果你只是想体验一下电子签名产品长什么样，官方有 Demo 站，可以在线玩
延伸推荐
• OpenSign（GitHub 9k+ Star）：另一个 DocuSign 开源替代，Node.js 技术栈，微服务架构 • Lemon Squeezy：偏电商场景的支付+数字产品销售平台，内置合同签署能力
结语
电子签名这个赛道看起来垂直，但实际需求覆盖面很广。从 SaaS 产品集成到企业内部流程，但凡涉及到"双方确认"的场景都绕不开。DocuSeal 做得比较扎实的一点是，它没有在花哨的功能上发力，而是把"上传文档、定义字段、发送签署、回收归档"这条主链路做得足够顺滑。对于需要电子签名能力的团队来说，这是一个值得认真看的开源方案。
源码获取请后台私：DocuSeal
我是刘哥聊技术，开源技术分享博主，独立出海开发者。日常分享 Java 技术、开源项目和 AI 工具实战经验，欢迎一起交流。
往期项目
开源|一款周增 6000 Star，多个 AI Agent 组建投研团队协作做量化交易Agents
开源|一款 174k Star 的 AI 编码方法论框架，可组合技能系统让 AI 遵循完整工程流程，防止 AI 偷懒跳过流程
开源|一款阿里达摩院发布的Java Agent 框架，支持MCP,Skill,Rag,模态,状态管理等快速实现
开源|一个用不花钱的模型跑 Claude Code 的代理方案
了解更多
#DocuSeal、#电子签名、#开源DocuSign 替代、#开源电子签约平台、#PDF 数字签名、#合同签署 SaaS、#文档签名 API、#白标电子签名#eSignature、#文档数字化、#SaaS 基础设施
