简介DocuSeal 是一个开源的数字文档签署和处理平台提供安全、高效的电子签名解决方案。它允许用户创建可填写和签署的 PDF 表单可在任何设备上使用具有易于使用的、移动优化的 Web 工具。DocuSeal 是 DocuSign 的开源替代方案可自托管部署。官方网站: https://www.docuseal.comGitHub 仓库: https://github.com/docusealco/docuseal在线演示: https://demo.docuseal.tech许可证: AGPLv3 with Section 7(b) Additional TermsGitHub Stars: ~14,000核心功能文档签署流程功能说明PDF 表单字段构建器 (WYSIWYG)可视化编辑器用于创建可填写的 PDF 表单12 种字段类型包括签名、日期、文件、复选框等字段类型多签署人支持允许多人签署同一份文档自动 PDF 电子签名数字签名自动应用到文档PDF 签名验证内置签名验证功能移动端优化响应式设计支持任何设备模板与表单通过 HTML API 创建模板: 可编程创建可填写表单通过 PDF/DOCX 字段标签创建模板: 使用嵌入式文本字段标签嵌入式签署表单: 支持 React、Vue、Angular 和 JavaScript嵌入式文档表单构建器: 主要框架的集成 SDK通信与存储SMTP 自动邮件: 签署流程的邮件通知文件存储选项: 本地磁盘、AWS S3、Google Storage、Azure Cloud用户管理: 用户管理功能多语言支持: 7 种 UI 语言签署支持 14 种语言Pro 企业版功能功能说明公司 Logo 与白标定制品牌自定义用户角色管理权限管理自动提醒跟进通知SMS 邀请与验证通过短信进行身份验证条件字段与公式动态表单行为批量发送CSV/XLSX 导入批量签署SSO / SAML企业级身份认证模板创建 APIHTML API、PDF/DOCX 字段标签技术架构语言分布语言占比Ruby~43.9%Vue~32.1%HTML~24.3%JavaScript~13.8%SCSS~0.2%后端架构核心框架: Ruby on Rails (Ruby 4.0.1)主要后端技术:技术用途RailsWeb 核心框架Devise身份认证支持双因素Cancancan授权/权限管理Sidekiq后台任务处理PumaWeb 服务器Turbo-RailsHotwired 实时更新Pagy分页数据库支持:数据库说明SQLite3默认零配置PostgreSQL生产环境推荐MySQL支持trilogy gemPDF 处理:技术用途HexaPDFPDF 操作与签名RubyXLExcel/XLSX 处理Ruby-Vips图像处理云存储:服务GemAWS S3aws-sdk-s3Google Cloud Storagegoogle-cloud-storageAzure Blobazure-blob安全与认证:技术用途JWTAPI 认证ROTPTOTP 时间令牌RQRCodeQR 码生成Devise-Two-Factor双因素认证前端架构核心框架: Vue.js 3.3.2 Shakapacker主要前端技术:技术版本用途Vue 33.3.2组件框架Hotwired Turbo-实时页面更新TailwindCSS3.4CSS 框架DaisyUI3.9Tailwind 组件库Shakapacker9.5Rails Webpack 集成Webpack5.104模块打包富文本与表单:技术版本用途TipTap3.19富文本编辑器CodeMirror6代码编辑Signature Pad4.1数字签名捕获架构模式混合单体架构: Rails 单体后端 Vue.js 嵌入组件通过 Shakapacker。使用 Hotwired Turbo 进行服务器驱动的导航Vue 用于交互式组件签名板、表单构建器、富文本编辑器。安装与部署Docker 快速启动# 使用 SQLite最简单dockerrun--namedocuseal-p3000:3000-v.:/data docuseal/docusealDocker Compose 生产部署# 下载配置文件curlhttps://raw.githubusercontent.com/docusealco/docuseal/master/docker-compose.ymldocker-compose.yml# 启动自动 SSLsudoHOSTyour-domain-name.comdockercompose upDocker Compose 包含app: DocuSeal 应用端口 3000postgres: PostgreSQL 18 数据库caddy: 反向代理自动 SSL云平台一键部署平台部署链接Heroku一键部署Railway一键部署DigitalOcean一键部署Render一键部署环境变量配置数据库配置变量说明DATABASE_URLPostgreSQL/MySQL 连接 URL空则使用 SQLiteDATABASE_HOST数据库主机DATABASE_PORT数据库端口默认 5432DATABASE_USER数据库用户名DATABASE_PASSWORD数据库密码DATABASE_NAME数据库名称存储配置本地存储:变量说明WORKDIR数据存储目录默认.ACTIVE_STORAGE_PUBLIC设为true公开文件访问AWS S3:变量说明AWS_ACCESS_KEY_IDAWS 访问密钥AWS_SECRET_ACCESS_KEYAWS 密钥AWS_REGIONAWS 区域默认 us-east-1S3_ATTACHMENTS_BUCKETS3 存储桶名称S3_ENDPOINT自定义 S3 端点Google Cloud Storage:变量说明GCS_CREDENTIALSGCS 凭证 JSONGCS_PROJECTGCS 项目名称GCS_BUCKETGCS 存储桶名称Azure Blob Storage:变量说明AZURE_STORAGE_ACCOUNT_NAMEAzure 存储账户AZURE_STORAGE_ACCESS_KEYAzure 访问密钥AZURE_CONTAINERAzure 容器名称SMTP 邮件配置变量说明SMTP_ADDRESSSMTP 服务器地址SMTP_PORTSMTP 端口默认 587SMTP_DOMAINSMTP 域名SMTP_USERNAMESMTP 用户名SMTP_PASSWORDSMTP 密码SMTP_AUTHENTICATION认证方式默认 plainSMTP_ENABLE_STARTTLS启用 STARTTLS默认 true安全配置变量说明SECRET_KEY_BASERails 密钥未设置时自动生成FORCE_SSL强制 SSL 的域名RAILS_ENV环境模式productionRedis 配置变量说明REDIS_URLRedis 连接 URL未设置时自动创建本地实例API 文档API 端点资源端点方法说明Submissions/submissionsGET, POST列出/创建提交/submissions/{id}GET, DELETE获取/删除提交/submissions/{id}/documentsGET获取提交文档/submissions/pdfPOST从 PDF 创建提交/submissions/docxPOST从 DOCX 创建提交/submissions/htmlPOST从 HTML 创建提交Templates/templatesGET列出所有模板/templates/{id}GET获取模板/templates/pdfPOST从 PDF 创建模板/templates/docxPOST从 DOCX 创建模板/templates/htmlPOST从 HTML 创建模板/templates/mergePOST合并模板Submitters/submittersGET列出所有签署人/submitters/{id}GET, PATCH获取/更新签署人API 服务器:区域URL美国https://api.docuseal.com欧洲https://api.docuseal.eu认证使用X-Auth-Token头进行 API Key 认证curlhttps://api.docuseal.com/templates-HX-Auth-Token: API_KEY获取 API Key注册 https://docuseal.com/sign_up访问 https://console.docuseal.com/apiWebhooksWebhook 类型说明Form Webhook表单提交时触发Submission Webhook提交状态变更时触发Template Webhook模板事件触发SDK 支持API SDK语言/平台包名安装命令JavaScript/TypeScriptdocuseal/apinpm install docuseal/apiPythondocusealpip install docusealRubydocusealgem install docusealPHPdocusealco/docuseal-phpcomposer require docusealco/docuseal-phpCLIdocusealnpm install -g docuseal嵌入式组件 SDK框架包名文档Reactdocuseal/reactReact 文档签署Vuedocuseal/vueVue 嵌入表单Angulardocuseal/angularAngular 嵌入表单集成示例React 嵌入签署表单import React from react import { DocusealForm } from docuseal/react function App() { return ( DocusealForm srchttps://docuseal.com/d/LEVGR9rhZYf86M emailsubmitterexample.com onComplete{(data) console.log(签署完成!, data)} / ) }JavaScript/HTML 嵌入scriptsrchttps://docuseal.com/js/embed.js/scriptdocuseal-formsrchttps://docuseal.com/d/LEVGR9rhZYf86M/docuseal-formAPI 创建提交constrespawaitfetch(https://api.docuseal.com/submissions,{method:POST,headers:{X-Auth-Token:API_KEY,Content-Type:application/json},body:JSON.stringify({template_id:123,send_to:[signerexample.com],submitters_order:random,submitters:[{email:submitterexample.com,name:John Doe,fields:[{name:signature_field,value:}]}]})});constdataawaitresp.json();console.log(data);Python SDK 使用fromdocusealimportDocuseal docusealDocuseal(api_keyAPI_KEY)submissionsdocuseal.list_submissions(limit10)Ruby SDK 使用requiredocusealDocuseal.keyAPI_KEYsubmissionsDocuseal.list_submissions(limit:10)生产部署示例# docker-compose.yml 生产配置services:app:image:docuseal/docuseal:latestports:-3000:3000volumes:-./docuseal:/data/docusealenvironment:-DATABASE_URLpostgresql://user:passwordpostgres:5432/docuseal-SMTP_ADDRESSsmtp.example.com-SMTP_USERNAMEuserexample.com-SMTP_PASSWORDyourpassword-FORCE_SSLyour-domain.compostgres:image:postgres:18environment:POSTGRES_USER:userPOSTGRES_PASSWORD:passwordPOSTGRES_DB:docuseal自托管最低要求最小配置SQLite 模式:Docker 容器端口 3000数据持久化卷/data生产配置:PostgreSQL 或 MySQL 数据库Redis自动配置或通过REDIS_URLSMTP 服务器邮件通知可选S3/GCS/Azure 文件存储SSL 终止使用FORCE_SSL或反向代理应用场景行业应用金融银行贷款合同、开户协议医疗健康患者同意书、医疗记录交通物流运输合同、货物签收房地产租赁合同、买卖协议电子商务用户协议、订单确认KYC 认证身份验证文档CRM 系统客户合同管理资源链接资源链接官方网站https://www.docuseal.comGitHub 仓库https://github.com/docusealco/docusealAPI 文档https://www.docuseal.com/docs/apiOpenAPI 规范https://editor.swagger.io/?urlhttps://console.docuseal.com/openapi.ymlPostman 集合https://www.postman.com/docuseal/docuseal/collection/baauu23/docuseal-api嵌入式签署文档https://www.docuseal.com/docs/embeddedReact SDKhttps://github.com/docusealco/docuseal-reactVue SDKhttps://github.com/docusealco/docuseal-vueAngular SDKhttps://github.com/docusealco/docuseal-angularJS SDKhttps://github.com/docusealco/docuseal-jsPython SDKhttps://github.com/docusealco/docuseal-pythonRuby SDKhttps://github.com/docusealco/docuseal-rubyPHP SDKhttps://github.com/docusealco/docuseal-phpDiscord 社区https://discord.gg/qygYCDGck9Docker Hubhttps://hub.docker.com/r/docuseal/docuseal快速开始指南评估功能使用 Docker 快速启动docker run --name docuseal -p 3000:3000 -v .:/data docuseal/docuseal访问 http://localhost:3000 测试功能创建模板并测试签署流程生产部署使用 docker-compose.yml 配置 PostgreSQL配置 SMTP 邮件发送设置FORCE_SSL启用 HTTPS可选配置云存储S3/GCS/AzureAPI 集成注册获取 API Key选择合适的 SDKReact/Vue/Angular/JS/Python/Ruby嵌入签署表单或使用 REST API总结DocuSeal 是一个功能完整的开源电子签名平台具备开源免费: AGPLv3 许可证可自托管技术栈现代: Ruby on Rails Vue.js 3 TailwindCSS部署灵活: Docker、云平台一键部署API 完善: REST API 多语言 SDK嵌入集成: React/Vue/Angular 嵌入组件企业功能: SSO、批量发送、白标定制适合需要自托管电子签名解决方案的企业和开发者是 DocuSign 等商业产品的优质开源替代方案。