需将draw.io嵌入confluence以实现页面内图表创建编辑：一、通过marketplace在线安装插件；二、离线环境手动上传匹配版本的.obr包；三、配置安全与编辑器设置确保svg渲染及交互；四、通过空间权限与插件配置管控图表操作范围。
如果您希望在Confluence页面中直接创建、编辑和保存图表，而无需跳转至外部绘图工具或手动截图上传，则需将draw.io（diagrams.net）以嵌入方式集成至Confluence。以下是实现该集成的具体路径：
一、通过Atlassian Marketplace在线安装插件
此方法适用于Confluence Cloud及支持Marketplace直连的Data Center环境，操作便捷且由系统自动处理依赖关系。插件安装后即可在编辑器工具栏中调用draw.io图形面板。
1、以管理员身份登录Confluence，进入设置 > 管理应用 > 查找新应用。
2、在搜索框中输入draw.io或diagrams.net，从结果中选择官方发布的draw.io Diagrams for Confluence应用。
3、点击免费试用或获取应用按钮，确认权限请求并完成安装流程。
4、安装完成后，进入任意页面编辑模式，在工具栏中查找插入 > draw.io diagram图标，点击即可启动嵌入式编辑器。
二、手动上传.obr插件包（适用于Server/Data Center离线环境）
当Confluence部署于无外网访问能力的内网环境中时，必须通过本地上传.obr格式插件包完成集成。该方式要求严格匹配Confluence主版本与插件兼容性列表，否则将导致加载失败或功能缺失。
1、访问Atlassian Marketplace中draw.io插件页面，展开版本历史，定位与您Confluence版本完全一致的发布项（例如Confluence 7.19.10对应插件版本9.5.8）。
2、点击该版本旁的Download链接，保存扩展名为.obr的文件至本地。
3、返回Confluence管理后台，进入设置 > 管理应用 > 上传应用，选择已下载的.obr文件并上传。
4、上传成功后，等待插件状态变为已启用，刷新页面编辑器，确认draw.io图标已出现在插入菜单中。
三、启用页面级嵌入功能并验证渲染能力
插件安装仅完成基础集成，还需确保Confluence全局配置允许SVG与内联脚本执行，否则draw.io图表可能无法正常加载或交互失效。此步骤直接影响嵌入内容的可视化完整性与编辑可用性。
1、管理员进入设置 > 安全配置 > 宏安全配置，确认允许不受信任的宏选项处于启用状态。
2、检查设置 > 编辑器配置 > 富文本编辑器中是否启用高级宏支持，确保draw.io宏可被识别。
3、新建测试页面，点击插入draw.io diagram，绘制一个简单矩形后保存；返回查看模式，确认图表以可交互SVG形式呈现，而非静态PNG。
4、双击已保存图表，验证是否能重新进入编辑界面——若弹出空白编辑器或报错，说明前端资源未正确加载，需检查浏览器控制台Network标签页中diagrams.net相关JS/CSS资源是否返回200状态。
四、配置用户权限以控制图表创建与编辑范围
draw.io图表作为Confluence页面的一部分，其操作权限继承自页面空间的权限体系。但插件额外提供细粒度控制能力，可限制非授权用户执行导出、XML查看等敏感动作，防止图表元数据意外泄露。
1、进入空间设置 > 权限，为指定用户组分配编辑页面权限，这是使用draw.io编辑功能的前提。
2、在设置 > 管理应用 > draw.io Diagrams for Confluence > 配置中，关闭允许用户导出原始XML开关，阻止普通用户通过右键菜单提取图表底层结构。
3、如需禁止特定用户组插入新图表，可在空间权限中移除其添加附件权限——因draw.io图表在存储机制上被识别为特殊附件类型。
4、对含敏感架构图的空间，启用空间水印功能，并勾选在draw.io渲染图像上叠加水印选项，确保截图传播时仍可追溯来源。
