Proxylang 指南

四步驟設定

1. 1

   Add your site

   前往設定頁面並輸入您的網站網址，接著選擇網站所使用的平台。

2. 2

   Pick languages

   選擇網站的原始語言，再選取您想新增的目標語言。可新增的語言數量取決於您的方案。

3. 3

   Install

   選擇將腳本標籤新增至網站的方式。讓AI 為您處理：將我們的訊息貼上至ChatGPT、Claude 或Cursor。自行處理：複製一行程式碼並發佈。或傳送給您的開發人員：我們會為您撰寫電子郵件。WordPress 網站請使用外掛程式。

4. 4

   Check your site

   精靈會確認腳本是否已啟用。網站上將會出現語言切換器。

各平台的安裝指南：

選擇 Proxylang 連接方式

腳本標籤是預設選項，適用於所有網站。其他模式可增加搜尋引擎對其他語言的能見度。您稍後可在網域的「設定」分頁中變更模式；切換時網站不會離線。

了解頁面翻譯流程

使用腳本標籤時，頁面會照常從您的伺服器載入。接著腳本會向 Proxylang 請求每個句子的翻譯並進行替換。首次造訪頁面時，您會看到翻譯過程。後續造訪皆為即時，因為翻譯內容已被儲存。

使用 DNS Proxy 或混合模式時，Proxylang 會位於訪客（或搜尋引擎）與您的伺服器之間：

1. 1

   A visitor opens a translated addressyourdomain.com/es-es/page

2. 2

   Proxylang 從您的伺服器擷取原始頁面

3. 3

   AI 翻譯可見文字

   版面配置與程式碼保持不變。

4. 4

   翻譯後的頁面會被儲存並提供服務

   下一位訪客可立即取得。

5. 5

   SEO tags are added

   包含語言連結、標準網址等。

Short addresses also work. /es/about and /mx/about both redirect to /es-es/about.

填寫內容

• Brand Name. Your name in your site's language and in English. It is kept exactly as written in every language.
• Site Description. Two or three sentences: what you sell, who reads the site, the tone you want. Example: "Online shop for Korean skincare. Customers are women 25 to 40. Friendly, not formal." This also helps translate visitors' search queries.
• Landing Pages. Pick up to 20 pages (your home page, pricing) where headlines and calls to action should read like native marketing copy rather than a word-for-word translation.
• Translation Formality. Formal, casual or automatic. This one is chosen when you add the domain and cannot be changed later, because every saved translation depends on it.

您的條款

• A term is a word or phrase in your site's language, its translation, and the language it applies to. Add one with Add Term . Tick case sensitive if "Apple" and "apple" should be treated differently.
• Terms apply everywhere the phrase appears. Up to 5,000 terms per domain.
• Have a list already? Use Import with a CSV file. Columns: source_text, target_text, source_lang, target_lang, case_sensitive, notes . Export gives you the same format back.
• Tick rows and click Delete Selected to remove many at once.

永不翻譯

術語表頂端的「永不翻譯」卡片包含必須在所有語言中保持原樣的單字：您的品牌、產品名稱、Hashtag。最多可包含 100 個項目，每個項目最多 60 個字元。比對時區分大小寫，因此請輸入 "iPhone"，而非 "iphone"。

編輯翻譯

1. Go to Live Editor , pick the domain and click Start editing . Your site opens in a new tab with the editor bar on it. Shortcut: on any page of your site, press Esc twice and click Open editor .
2. Switch the site to the language you want to fix.
3. Click any text. A panel shows the Original and the Translation . Change the translation and click Save .

• You see your change at once. Other visitors see it within about five minutes.
• Your edit always wins. Proxylang will not overwrite it, and neither will AI improvements.
• Changed your mind? Open the same text and click Reset to automatic translation .
• Some text has placeholders like {0} for a link or bold word. Keep them in your translation, in any order.
• Only verified domains you own appear in the Live Editor.

保留原文內容

有些文字不應被翻譯：例如品牌名稱、優惠代碼、引述或客戶撰寫的評論。我們提供三種工具，從無需程式碼到需要少量程式碼的選項皆有。

• A single word or name, everywhere. Add it to the Never Translate list in the glossary. No code.
• A block on a page. Add the proxylang-no-translate class to the element. Everything inside it is skipped. See below.
• A whole file or region. Wrap it in the comment markers. See below.

使用 Class 跳過區塊

Add the class proxylang-no-translate to any element. The attribute data-proxylang-no-translate does the same thing. Works in every mode.

<!-- Everything inside is left in the original language -->
<div class="proxylang-no-translate">
  <h2>Brand Name™</h2>
  <p>SAVE20 is your coupon code.</p>
</div>

<!-- The attribute form does the same -->
<span data-proxylang-no-translate>Acme Corp</span>

使用註釋跳過區域

當您無法新增類別，或需要處理 JavaScript 檔案內的文字時，此功能非常實用。兩個標記之間的所有內容都將被略過。

<!-- @proxylang-do-not-translate-start -->
<div class="testimonial">
  Customer reviews stay exactly as written.
</div>
<!-- @proxylang-do-not-translate-end -->

已為您跳過

• Code samples inside <pre> and <code> , in every mode. Syntax highlighters that render into those tags (Shiki, highlight.js, Prism) are covered. Code editors that render into a plain <div> (CodeMirror, Monaco) are not; add the class to their wrapper.
• <kbd>, <var> and <samp> when Proxylang translates on the server (DNS Proxy and Hybrid).
• Legal pages at standard addresses. See the Legal pages section.
• Email addresses, URLs, numbers and prices.

僅針對搜尋引擎跳過

有時您會希望搜尋引擎索引原始文字（例如您希望排名的標語或口號），同時讓訪客閱讀翻譯後的內容。請使用僅限機器人的標記。這些標記僅適用於 Proxylang 為機器人提供頁面的情況，即 DNS Proxy 和 Hybrid 模式。若僅用於 script 標籤，則不會產生任何作用。

<!-- Search engines index the original wording.
     Visitors still see it translated. -->
<h2 class="proxylang-bot-only-no-translate">Our Brand Tagline</h2>

<!-- Attribute form -->
<p data-proxylang-bot-only-no-translate>Ranked slogan</p>

<!-- Comment form, for a larger region -->
<!-- @proxylang-bot-only-do-not-translate-start -->
<section>...</section>
<!-- @proxylang-bot-only-do-not-translate-end -->

法律頁面保留原文

合約的機器翻譯在法庭上可能不具法律效力，且冗長的法律頁面會無謂消耗您的字數額度。因此，Proxylang 會自動跳過這些頁面，除非您另有設定。

無需任何設定即可跳過的頁面

Proxylang 會根據頁面網址進行判斷。無論您使用何種方案或模式，以下頁面皆會被跳過：

• /privacy, /privacy-policy, /cookie-policy, /cookies, /gdpr
• /terms, /tos, /terms-of-service, /terms-and-conditions, /legal, /eula
• /disclaimer, /dmca, /copyright, /refund, /refund-policy, /return-policy, /shipping-policy
• German: /agb, /datenschutz, /impressum, /nutzungsbedingungen

系統僅會跳過頁面的主要內容。頁首、選單與頁尾仍會進行翻譯，確保訪客能順利瀏覽網站。

其他網址的法律頁面

If your legal page lives somewhere else (for example /about/policies), mark it yourself. Add the proxylang-no-translate class to the element that wraps the legal text. On a site builder, put the legal text in a code block or custom HTML element and add the class there.

<!-- Wrap the legal text, not the whole page -->
<main class="proxylang-no-translate">
  <h1>Privacy Policy</h1>
  <p>Last updated ...</p>
</main>

SEO 頁面

開啟 SEO 並選擇一個網站。這需要 Lite 方案或以上。由於僅靠腳本標籤時搜尋引擎無法看到翻譯後的標題，「關鍵字」與「頁面標題」分頁也需要 Hybrid 或 DNS Proxy 模式。

Health

A score from 0 to 100 and a to-do list. It checks that search engines can reach your translated pages, that the right tags are on them, and that setup is finished.

Keywords

Type up to 20 phrases your customers search for, in your own language. Proxylang writes a matching set for every language search engines index and uses them for your home page title and description. A language that joins them later gets its set shortly after you save, with no click. You can give a pricing or campaign page its own set.

Page Titles & Descriptions

See the title and description each language really shows in search results, and pin your own wording for any page. A pin is exact and final for that page and language. Too long? Click Shorten.

Settings

Bot translation budget, which pages go in the sitemap, and a switch to stop SEO tags while you test.

• Google Search Console. The Health checklist has a "Connect Google Search Console" step. It pulls Google's own indexing data into the Health tab. Available once Hybrid or DNS Proxy is on.
• Naver and Daum. If Korean is one of your languages, a card lists the four manual steps those engines need. Tick each one off as you go.
• AI answers. A second checklist covers listings that help ChatGPT, Gemini and Perplexity recommend you: Wikidata, Google Business Profile and, for software, G2 and Product Hunt.

Which languages search engines see

Your plan sets how many languages search engines index. Visitors can still pick every language you turn on. A language you add joins the indexed ones on its own while your plan has room. It goes into the sitemap and language links, and if you have saved keywords on the Keywords tab, it gets its own keywords and home page title written from them. To choose them yourself, use the search icon next to each language on the domain's Languages tab.

When every slot is taken, the Languages tab and the SEO Keywords tab name the languages search engines can't see. Swap one in for an indexed language, or upgrade for more.

已翻譯頁面的標籤

• Language links (hreflang) that tell search engines which page is which language.
• A canonical address per language, so translations are not seen as duplicates.
• The page's language tag, for Bing and Baidu.
• Social preview locale, so shared links show the right language.

適用於混合模式與DNS 代理模式，搜尋引擎會從Proxylang 獲取頁面。若僅使用指令碼標籤，它們讀取的是您的原始網站。

<link rel="alternate" hreflang="en-US" href="https://example.com/page" />
<link rel="alternate" hreflang="es-ES" href="https://example.com/es-es/page" />
<link rel="alternate" hreflang="fr-FR" href="https://example.com/fr-fr/page" />
<link rel="alternate" hreflang="x-default" href="https://example.com/page" />
<link rel="canonical" href="https://example.com/es-es/page" />
<meta property="og:locale" content="es_ES" />

標題、描述與圖片文字

頁面標題、中繼說明、社群預覽標題與說明，以及關鍵字皆會進行翻譯。圖片替代文字、按鈕提示與表單預留位置亦然。您可在「頁面標題與說明」分頁中，為任何頁面固定您自訂的措辭。

複合式搜尋結果

若您的頁面包含結構化資料（即驅動 Google 豐富搜尋結果的隱藏產品、文章、常見問題或活動詳情），系統會翻譯其中的文字欄位並更新語言欄位。價格、日期、網址與識別碼則保持不變。

網站地圖

Proxylang builds a sitemap per language and lists them all at /sitemap.xml on your domain. Pages come from your own sitemap, plus pages Proxylang has seen. Each language also has its own file, such as /es-es/sitemap.xml . They refresh daily, and right away when a language save changes which languages search engines see; click Regenerate sitemap on the SEO Settings tab to rebuild now.

<?xml version="1.0" encoding="UTF-8"?>
<sitemapindex xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
  <sitemap><loc>https://example.com/sitemap-1.xml</loc></sitemap>
  <sitemap><loc>https://example.com/es-es/sitemap.xml</loc></sitemap>
  <sitemap><loc>https://example.com/fr-fr/sitemap.xml</loc></sitemap>
</sitemapindex>

選擇地圖中包含的頁面

在「SEO 設定」分頁下的「網站地圖頁面」：

• All pages. The default.
• Only specific paths. Start with a few pages, add more later.
• Exclude paths. Hide a section, such as /internal/*.

One path per line. * matches anything, so /blog/* covers every blog post. The home page is always included. Subdomains use their root domain's setting.

向搜尋引擎提交新頁面

• Bing, Yandex, Naver, Seznam and Yep are told the moment a translated page is saved. DuckDuckGo, Ecosia and Qwant use Bing's index. Nothing to set up.
• Google does not take pings. It finds your pages through the sitemap and the language links. Connecting Search Console lets you watch it happen.
• Your robots.txt is served with the sitemap lines added. Your own rules are kept.

AI 搜尋引擎

• robots.txt allows GPTBot, ChatGPT-User, ClaudeBot, PerplexityBot and Google-Extended.
• A /llms.txt file describes your site and lists its languages and sitemaps for AI tools that look for one.
• AI bots get translated pages only in Hybrid or DNS Proxy mode. They are counted under the bot budget like any other crawler.

功能說明

指令碼標籤會在訪客的瀏覽器中翻譯頁面。由於搜尋引擎不會執行該指令碼，因此它們只能看到您的原始語言。混合模式解決了這個問題。

使用 Wix、Squarespace、Webflow 等網站建置工具的網站無法以這種方式變更 DNS，因此將維持使用指令碼標籤。

如何啟用

沒有所謂的「混合」開關。當同一個網域同時開啟 DNS 代理與指令碼標籤時，即為混合模式。

1. 1

   開啟您的網域，然後進入「設定」分頁

   網域 → 您的網域 → 設定。

2. 2

   Turn on DNS Proxy

   在您的網域註冊商處新增我們提供的 DNS 記錄，然後進行驗證。此步驟能讓搜尋引擎存取 Proxylang。

3. 3

   Keep Script Tag on

   您的訪客將繼續使用您已安裝的指令碼標籤。

4. 4

   Done

   兩者皆開啟時，網域徽章會顯示「混合 (SEO)」。關閉其中任何一項，網站即會切換回另一種模式，且不會造成停機。

費用說明

機器人造訪會消耗您的額度，費率為正常費率的四分之一。三項限制可防止失控的爬取行為耗盡額度。您可以在「設定」頁面的 SEO 區塊中調低各項限制。

可新增內容

• Subdomains of a site you already added (app.yourdomain.com, shop.yourdomain.com). Free on every plan. They do not count toward your domain limit.
• Separate root domains (yourdomain.com and yourapp.io). Needs the Start plan or above, which carries as many as you like. Test Drive and Lite cover one site.

所有網站共用同一個字數額度。新增第二個網站不會增加字數，而是從同一個額度池中扣除。

若您之後降級至較小的方案，網站不會下線。您已新增的網站皆會保留，只是在恢復至限制內前，無法再新增網站。

子網域繼承內容

子網域會繼承其根網域的設定，包含連線模式、語言、網站地圖設定以及進階分頁中的開關。您只需在根網域設定一次即可。

若根網域使用 DNS 代理或混合模式，每個子網域也需要各自的 DNS 記錄。應用程式會顯示需新增的確切記錄：根網域需四筆（裸網域、www及兩筆驗證記錄），子網域則需兩筆。

功能說明

在您的網站上顯示聊天氣泡。訪客以其母語輸入，您則以您的語言閱讀並回覆。雙方對話即時翻譯。單一訂閱涵蓋帳戶下所有網站，且支援無限數量的客服人員。

開啟功能

開啟網域，前往「即時聊天」分頁並開啟開關。對話框會出現在您的網站上，且網站會顯示在您 Chat 的聊天控制台中。

• On Start and above, chat is already included with your plan. Nothing to buy and no trial to start.
• On Test Drive and Lite, every account gets one 14-day trial with 2,000 translated messages. No card needed. The trial is per account, not per site.
• When nobody is online, visitors see "We are away" and can leave their email. You answer by email from the console. Turn this off in widget settings if you prefer.

新增團隊

1. On the Live Chat tab, in the Agents card, type a teammate's email and click Invite . Seats are free and unlimited.
2. They get a link, good for seven days. They enter the name visitors will see and the language they want to read chats in.
3. They see that site's conversations only, marked "Shared". No settings, no billing.

點擊該列上的「移除」按鈕來移除人員。

回覆對話

• The console has three panes: conversations, the open chat, and visitor details (page they are on, country, past chats).
• Having the console open makes you "Online". Click the pill to go "Away"; visitors then get the offline form.
• Type / in the reply box for quick replies (hello, order, refund, shipping).
• You can send images up to 10 MB. Edit a sent message and the visitor's translation is redone.
• If a teammate is already answering, your reply box locks so the visitor never gets two answers.
• Under Chat settings → Widget , set the bubble colour, position, greeting and the name visitors see. The greeting is shown as written and is not translated yet.

桌面與行動版應用

下載頁面提供 macOS、Windows 與Linux 的桌面應用程式。即使在瀏覽器關閉時，它也能提供通知與未讀標記，並會自動更新。iPhone 與Android 應用程式列為即將推出。

登入時會暫時開啟您的預設瀏覽器，隨後會自動返回應用程式。這是正常現象。

設定

1. Buy credits

每個網域皆已開啟圖片翻譯功能。您的點數餘額是唯一的門檻。請至帳單頁面購買點數包。點數包有效期為12 個月。

10 images

$5 / ₩7,000

$0.50 per image

50 images

$20 / ₩28,000

$0.40 per image

100 images

$35 / ₩49,000

$0.35 per image

2. 選擇要翻譯的圖片

僅翻譯您指定的圖片。提供三種方式，由簡入繁：

• Live Editor. Open your site, press Escape twice, sign in, click Image Translation in the editor bar and tap the images. Works on any platform.
• Paste image addresses. On the domain's Image Translations tab, use Auto-Translate Images by URL . Good for site builders where you cannot edit HTML.
• Tag the HTML. Add data-pl-translate-image to the image tag.

<!-- Only tagged images are translated -->
<img src="/hero-banner.png" data-pl-translate-image alt="Welcome" />

<!-- Any image source works -->
<img src="https://cdn.example.com/promo.jpg" data-pl-translate-image />

後續處理與費用

• The first visitor in a language sees the original image. Translation runs in the background, usually under two minutes, then the translated image replaces it on the page without a refresh.
• Every visitor after that gets the translated image instantly. It is kept forever.
• One credit per image, per language. The same banner in Korean and Japanese costs two credits.
• Images whose longer side is over 2000px cost two credits per language. Tall product detail images usually fall in this group.
• Visitors reading your site in its own language never use credits.

適用於所有模式。使用「貼上圖片網址」方法時，比對程序會在訪客的瀏覽器中執行，因此需要腳本標籤（腳本標籤或混合模式）。

設定

1. Buy searches

使用預付搜尋點數支付。請至帳單頁面購買點數包。點數包永不過期。

10,000 searches

$9.99 / ₩13,900

50,000 searches

$39.99 / ₩55,900

200,000 searches

$139.99 / ₩194,000

2. 針對網域啟用

開啟網域，前往「進階」分頁並開啟「翻譯搜尋查詢」。在您擁有點數之前，此開關將保持關閉狀態。設定生效至您的正式網站可能需要最多五分鐘，請在測試前稍作等待。

運作方式

If your search box is a normal form, or its field is named q, query, search, keyword, term or s, it works with no changes. When the visitor presses Enter, Proxylang translates the query and your search receives the translated text.

<form action="/search" method="GET">
  <input type="search" name="q" />
  <button type="submit">Search</button>
</form>

• Runs from the script tag, so it works in script tag and Hybrid mode. Not on DNS Proxy-only sites.
• Visitors reading your site in its own language are not affected and use no credits.
• Each search uses one credit, including repeats. Translated queries are remembered per domain, so repeats are instant.
• If translation takes longer than 4.5 seconds, the original query is sent through instead. Visitors never wait on a spinner.

頁面列表篩選搜尋框

有些搜尋框不會將任何內容傳送到伺服器，而是直接篩選頁面上現有的列表（例如常見問題或產品網格）。這類搜尋框需要在輸入欄位中加入一個屬性：

<!-- Translate when the visitor presses Enter (default) -->
<input type="text" placeholder="Search..." data-proxylang-reverse-search />

<!-- Translate as they type, after a short pause -->
<input type="text" placeholder="Search..." data-proxylang-reverse-search="live" />

By default the query is translated when the visitor presses Enter. Add ="live" to translate as they type, after a short pause. Live mode uses more credits, one per pause.

提供上下文輔助翻譯

A one-word query can mean many things. Proxylang uses the Site Description from your Brand & Context tab to pick the right meaning. For one specific search box you can override it with data-proxylang-search-context="..." on the input (up to 240 characters).

實用技巧

• Keep Enter mode unless your search really needs results while typing. It costs a fraction of live mode.
• Write a clear Site Description. "Korean skincare shop" gives better query translations than "our website".
• Test in a private window with the site switched to another language.

可自訂項目

Activate Switcher

The on/off switch for the widget on this site. Also holds a test key for trying the script on your own computer.

Layout

Floating in a corner, or inline where you place it. Starting corner. Whether visitors can drag it.

Appearance

Button size, menu size, corner shape, shadow, and whether languages show as "EN", "English" or both.

Colors

Six ready-made themes, or your own colours for light and dark mode.

Behavior

Shrink to an icon after a few seconds, menu animation, and a soft fade when translated text appears.

Branding

Hide the "Translation by Proxylang" line in the menu. Start plan and above.

Loading Indicators

A spinner, a thin bar at the top, both, or nothing while a page translates.

Dark Mode Detection

Follow the visitor's system setting, or tell Proxylang which CSS class your site uses for dark mode.

Advanced

Stacking order, the width at which the mobile layout kicks in, and the right-to-left auto-flip switch.

變更會在數秒內同步至您的網站，最長不超過五分鐘。若未看到變更，請重新整理頁面。

訪客首選語言

無需設定。首次造訪時，Proxylang 會偵測訪客瀏覽器的偏好語言，並從您啟用的語言中選出最佳匹配。若無匹配，則依據訪客所在國家，最後使用您網站的預設語言。之後，系統會記憶訪客的選擇長達一年。

To test another language, open your site in a private window, or add ?lang=ko-KR to the address.

訪客流量與語言統計

儀表板上的「分析」分頁會顯示訪客數、造訪次數、頁面、訪客來源、國家與裝置，以及閱讀翻譯版本的比例。系統不會使用 Cookie；訪客是透過無法還原為地址的混淆指紋進行計算。

• A visit ends after 30 minutes without activity.
• Bots are hidden by default, and so is your own traffic from a development machine. Use the Filter button to show them.
• Detailed records are kept for 90 days.
• The Visitor Map shows the same data on a world map.

方案權益

每個方案都有字數額度、每月頁面瀏覽額度、語言數量與網站數量限制。字數額度是總額而非每月額度：句子僅在第一次翻譯時計算，之後便會保持翻譯狀態。每種語言皆分開計算：一個 500 字的頁面若以三種語言開啟，將消耗 1,500 字。從入門版及以上方案開始，訪客可以選擇 77 種語言中的任何一種，而方案會設定搜尋引擎可以索引其中的多少種。爬蟲會抓取每個被索引的語言，因此這些語言會在沒有訪客的情況下消耗字數。

• Global, Enterprise and Custom plans are arranged through the Custom card on the pricing page.
• Lite and above add per-language SEO and Hybrid mode. Pro and above add DNS Proxy mode.
• Words used up. New text stays in the original language until you upgrade. Text already translated keeps showing, and the language switcher keeps working. There is no overage charge.
• Page views used up. The same happens for one month, then the whole site is served in its original language until the next month or an upgrade.
• Bot visits in Hybrid and DNS Proxy mode count at a quarter of the rate.
• Yearly billing is ten months for twelve.
• Moving to a smaller plan never takes a site offline. You keep what you have and cannot add more until you fit.

更改或取消

• Open Billing and pick a plan under Available Plans . A change takes effect at once. The price difference is settled on your next invoice.
• New subscriptions on Start or Pro (monthly, paid in USD, outside Korea) start with a 14-day free trial.
• Korean customers pay in KRW through KG이니시스, with VAT shown separately. Yearly Korean plans are a one-time payment you renew by hand. Cancel with the 해지 button; you keep access to the end of the period.
• Every charge and receipt is under Payment History at the top of the Billing page.

圖片與搜尋額度

付費方案在您首次訂閱時會包含一次性的點數包：Lite 方案包含 2 張圖片與 500 次搜尋；入門版包含 10 張圖片與 2,000 次搜尋；Pro 方案包含 30 張圖片與 2,000 次搜尋；Business 與 Global 方案則包含 100 張圖片與 2,000 次搜尋。升級方案僅需支付差額。贈送的點數永不過期，且每個帳號僅授予一次，而非每次升級都授予。

如果額度用完，可以在「帳單」頁面、「圖片翻譯」頁面或「反向搜尋」頁面購買預付包。點數包可在您的所有網站間共用。購買的圖片包有效期為 12 個月，系統會在到期前 30 天發送電子郵件通知；購買的搜尋包則永不過期。

購買頁面將於新分頁開啟。當您返回「帳單」頁面時，餘額將會自動更新。

優惠碼

• Outside Korea there is no code box. Your discount is attached to your account and applied at checkout on its own.
• In Korea, the code box is on the Billing page while you are on the free plan. Codes apply to the first payment only.
• Discounts do not stack. The largest one wins.