GitLab CE 10.4.3 Wiki API图片获取及外部集成问题咨询

针对你在GitLab CE 10.4.3集成Wiki到外部门户时遇到的图片加载问题，我整理了几个实用的解决方案，帮你搞定这个问题：

GitLab CE 10.4.3的Wiki API支持直接返回渲染后的HTML内容，返回结果里的图片会带有完整的GitLab访问路径，前端可以直接加载。具体操作：

• 调用Wiki页面API时，在请求头中设置 Accept: text/html，或者在URL参数里添加 format=html（示例请求：GET /projects/:id/wikis/:slug?format=html）。
• 注意：如果外部门户和GitLab不在同一域名下，会触发跨域问题。你可以在GitLab配置中添加外部门户域名到CORS允许列表，或者通过后端做API代理，避免前端直接请求时的跨域限制。

GitLab的Wiki附件可以通过API直接获取，步骤如下：

• 先从Wiki的原始Markdown中提取图片相对路径，比如 ![alt](uploads/abc123/image.png)，其中abc123是附件的随机标识。
• 调用GitLab附件API：GET /projects/:id/wikis/attachments/:file_path，这里的file_path就是Markdown里的相对路径（比如uploads/abc123/image.png），请求时需带上GitLab私有令牌（请求头 PRIVATE-TOKEN: your-access-token）验证权限。
• 你也可以直接用渲染后HTML里的图片URL访问，但同样要处理权限和跨域问题，建议通过后端代理图片请求，避免在前端暴露私有令牌。

除了API获取内容的方式，还有几种更灵活的思路：

• 反向代理嵌入：用反向代理将GitLab Wiki路径映射到外部门户域名下，比如外部门户的/wiki路径代理到GitLab的/projects/:id/wikis。这样你可以用iframe嵌入GitLab Wiki页面，或者直接渲染Wiki的HTML，图片链接域名和门户一致，无跨域问题，还能复用GitLab的Wiki编辑功能。
• 定时同步内容：写个脚本（比如Python或Shell脚本），定时通过GitLab API拉取所有Wiki页面的Markdown和附件，把附件同步到外部门户的文件存储（本地服务器或云存储），同时修改Markdown里的图片链接为外部门户路径。前端用ng-showdown渲染修改后的Markdown，完全脱离GitLab依赖，适合需要高度定制展示样式的场景。
• 后端代理渲染：前端不直接请求GitLab API，而是通过你的后端服务获取Wiki内容。后端拿到原始Markdown后，先替换图片链接为代理后的路径，再用Markdown渲染库（比如Node.js版的Showdown）生成HTML返回给前端，既解决跨域问题，又能统一控制图片访问权限。

内容的提问来源于stack exchange，提问作者Vincendeau Julien