如何配置Docker版YouTrack知识库支持自定义外部源以iframe嵌入？

可以实现，主要通过调整YouTrack的内容安全策略（CSP）和知识库嵌入白名单来完成，具体步骤如下：

1. 调整内容安全策略（CSP）允许目标源加载iframe #

Docker部署的YouTrack可以通过两种方式修改CSP规则：

方式一：启动容器时通过环境变量指定 #

在docker run命令中添加JETTY_OPTS环境变量，将你的diagrams.net实例地址加入frame-src指令：

docker run -d \
  # 保留你现有容器的端口映射、数据卷挂载等参数
  -p 8080:8080 \
  -v youtrack_data:/opt/youtrack/data \
  # 添加CSP配置
  -e JETTY_OPTS="-Djetbrains.youtrack.csp.frame-src='self' http://192.168.1.100:8081" \
  jetbrains/youtrack:latest

替换http://192.168.1.100:8081为你的本地diagrams.net实际访问地址，多个允许的源用空格分隔。

方式二：挂载自定义配置文件持久化设置 #

创建本地配置文件youtrack.conf，添加CSP相关配置：

jetbrains.youtrack.csp.frame-src="self http://192.168.1.100:8081"

启动容器时将该文件挂载到容器内的配置目录：

docker run -d \
  # 现有参数
  -p 8080:8080 \
  -v youtrack_data:/opt/youtrack/data \
  # 挂载自定义配置
  -v /path/to/your/youtrack.conf:/opt/youtrack/conf/youtrack.conf \
  jetbrains/youtrack:latest

2. 在YouTrack后台配置知识库嵌入白名单 #

1. 登录YouTrack管理员账户，进入设置 → 知识库 → 嵌入设置
2. 在允许的iframe源列表中，添加你的diagrams.net实例的完整地址（如http://192.168.1.100:8081）
3. 保存设置后，重启YouTrack容器使配置生效

额外注意事项 #

• 确保你的diagrams.net实例未设置阻止嵌入的HTTP头：检查diagrams.net的反向代理或容器配置，避免X-Frame-Options设为DENY或SAMEORIGIN（若YouTrack和diagrams.net不在同一域）。可临时设置X-Frame-Options: ALLOW-FROM http://your-youtrack-addr测试，生产环境建议严格控制源。
• 本地部署优先使用固定IP而非localhost，避免容器网络访问冲突。

内容的提问来源于stack exchange，提问作者knee-cola