要約

When changing the Base URL, either due to a URL change or from an export/import (e.g. Cloud to Server or Server to Server), links created as absolute links to the old Base URL (for example, using Insert > Link > Web Link) need to be manually changed.

サーバーからサーバーの例

クラウドからサーバーの例 (追加手順が必要)

What about relative links?

If a link was created as a relative link (for example, by using Edit > Insert > Link, then from "Recently Viewed" or "Search"), it will change when the base URL changes. 

This document has more details: Working with Links.

環境

Confluence Server または Data Center

ソリューション

オプション 1: エクスポート / インポート オプションでの検索と置換の使用

このオプションでは、Confluence データをエクスポートし、後述の sed スクリプトを活用した検索と置換によってリンクの値を更新する方法について説明します。

sed -r -e 's/oldvalue/newvalue/g' <export-file-name>

sed -r -e 's/mycompany.com\/confluence/confluence.mycompany.com/g' entities.xml

オプション 2: WebDAV オプション

WebDAV プラグインを使用して WebDAV の場所をローカルでマウントし、sed を使用してすべての古いベース URL を置換するスクリプトを実行します。このオプションにより、変更されたすべてのページの新しいページ バージョンが作成されます (これにはクロールおよび編集されたすべてのページ バージョンが含まれます)。

オプション 3: Confluence Source Editor オプション

Confluence Source Editor アプリを使用して、ページ単位でコンテンツを変更できます。

1. Confluence Source Editor アプリをインストールします。
2. 対象のページでエディタを開きます。
3. エディタの右上にある <> ボタンをクリックします。
4. 古いベース URL が表示されている箇所を新しいベース URL で置き換えます。
5. ページを保存します。

この方法はデータの直接操作よりもリスクが小さいメリットがあり、また、エディタのインターフェイスから手動で添付ファイルをリンクするよりも簡単です。 

Option 4: Database query

Confluence stores page content in plain text, on the 'BODYCONTENT' table. It's also possible to replace these links by replacing text on this table, with the following queries:

Starting from Confluence 7 (skip this step for older versions) we will need to set the flag on drafts to use content from pages when generating drafts instead of using Synchrony cache.

update CONTENTPROPERTIES set stringval='synchrony-recovery' where propertyname = 'sync-rev-source' and contentid in (select contentid from BODYCONTENT WHERE body LIKE '%old-URL%');

Replacing the links for all page versions (Compatible with PostgreSQL, Oracle, MySQL)

UPDATE BODYCONTENT 
SET body = replace(body,'old-URL','new-URL') 
WHERE body LIKE '%old-URL%';

# Assuming that the HTTP protocol remains the same, specify the URL without a reference to the protocol. For example:
UPDATE LINKS 
SET destpagetitle = replace(destpagetitle,'//the.old-URL.com','//my.new-URL.com') 
WHERE destpagetitle LIKE '%//the.old-URL.com%';
UPDATE LINKS 
SET lowerdestpagetitle = replace(lowerdestpagetitle,'//the.old-url.com','//my.new-url.com') 
WHERE lowerdestpagetitle LIKE '%//the.old-url.com%';

# Make sure to set the URL in the last SQL query to lowercase

Replacing the links for all page versions (Compatible with SQL Server 2017 - Microsoft Docs - ntext, text, and image (Transact-SQL))

UPDATE BODYCONTENT
   SET BODY = REPLACE (CONVERT(VARCHAR(MAX), BODY), 'old-URL','new-URL')
 WHERE BODY LIKE '%old-URL%';

Extra: Replacing the links for the latest versions of pages from active spaces (Compatible with PostgreSQL)

UPDATE BODYCONTENT
SET BODY = REPLACE (BODY,'old-URL','new-URL')
WHERE BODYCONTENTID IN (SELECT bc.BODYCONTENTID
                        FROM BODYCONTENT bc
                        INNER JOIN CONTENT c ON c.CONTENTID = bc.CONTENTID
                        INNER JOIN SPACES s ON s.SPACEID = c.SPACEID
                        WHERE bc.BODY LIKE '%old-URL%'
                          AND c.PREVVER is NULL
                          AND c.CONTENTTYPE ='PAGE'
                          AND c.CONTENT_STATUS = 'current'
                          AND s.SPACESTATUS = 'CURRENT');

This will replace all instances of 'old-URL' on pages, with the text from 'new-URL', automatically replacing the links on Confluence pages.

•  Restart Confluence or flush the cache in General Configuration → Cache Management to have these changes be reflected in the UI.

 Try this on a test Confluence instance beforehand, and backup the Confluence database first