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代理或混合模式时，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.

永不翻译

术语表顶部的“永不翻译”卡片用于存放在所有语言中都必须保持原样不变的词汇：例如品牌名、产品名或标签。最多支持 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代理和混合模式。仅在脚本标签上使用时，它们不会产生任何效果。

<!-- 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丰富结果的隐藏产品、文章、常见问题解答或活动详情），其中的文本字段会被翻译，语言字段也会相应更新。价格、日期、URL和标识符将保持不变。

网站地图

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 词。在 Start 计划及以上，访客可以从 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 次搜索，Start 计划包含 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.