From 5a77f04db424108d6b74614b365bedeaaf0c1209 Mon Sep 17 00:00:00 2001 From: rustdesk Date: Tue, 14 Jul 2026 17:33:00 +0800 Subject: [PATCH] fix robots --- .../address-book/_index.ko.md | 139 ++++++++++++++++++ hugo.yaml | 7 +- layouts/sitemap.xml | 25 ++++ v3/src/pages/robots.txt.ts | 19 +-- v3/src/utils/seo.ts | 15 +- v3/vendor/integration/index.ts | 48 +----- 6 files changed, 186 insertions(+), 67 deletions(-) create mode 100644 content/self-host/rustdesk-server-pro/address-book/_index.ko.md create mode 100644 layouts/sitemap.xml diff --git a/content/self-host/rustdesk-server-pro/address-book/_index.ko.md b/content/self-host/rustdesk-server-pro/address-book/_index.ko.md new file mode 100644 index 00000000..335314e3 --- /dev/null +++ b/content/self-host/rustdesk-server-pro/address-book/_index.ko.md @@ -0,0 +1,139 @@ +--- +title: 주소록 +weight: 201 +description: "RustDesk Server Pro에서 주소록을 사용하여 원격 장치를 저장하고, 장치 목록을 공유하고, 태그로 장치를 정리하고, RustDesk 클라이언트에서 공유 비밀번호로 연결하십시오." +keywords: ["rustdesk address book", "rustdesk server pro address book", "rustdesk shared address book", "rustdesk device tags", "rustdesk shared password"] +--- + +주소록을 사용하면 RustDesk 장치 ID를 저장하고, 태그로 정리하고, 장치 목록을 공유하고, RustDesk 클라이언트에서 저장된 비밀번호로 연결할 수 있습니다. + +## 빠른 답변 + +- **내 주소록**은 로그인한 사용자에게만 표시되는 개인 주소록입니다. 수동으로 입력한 후 기억된 비밀번호는 **내 주소록**에 저장되며 해당 사용자의 여러 장치 간에 동기화할 수 있습니다. +- **공유** 주소록은 특정 사용자, 사용자 그룹 또는 모든 사용자와 공유할 수 있습니다. +- 공유 주소록에는 주소록 수준 비밀번호를 저장할 수 있고, 각 장치 항목에는 장치 수준 비밀번호를 저장할 수 있습니다. 장치 수준 비밀번호가 설정되지 않은 경우 주소록 수준 비밀번호가 사용됩니다. +- 태그를 사용하여 웹 콘솔과 RustDesk 클라이언트에서 장치를 필터링할 수 있습니다. + +## 공유 주소록을 사용한 원클릭 연결 + +사용자가 매번 원격 비밀번호를 수동으로 입력하지 않고 연결해야 하는 경우 공유 주소록을 사용하십시오. + +1. 공유 주소록을 만들거나 엽니다. 필요한 경우 주소록에 **주소록 수준 비밀번호**를 설정합니다. + +2. 주소록 이름을 클릭하여 장치 페이지를 엽니다. **가져오기**를 클릭하고 주소록으로 가져올 장치를 선택한 다음, 하단의 **저장**을 클릭하여 선택한 장치를 저장합니다. 또는 **추가**를 클릭하여 ID로 장치를 추가합니다. 직접 IP 접근의 경우 IP 주소를 ID로 사용합니다. 필요한 경우 개별 장치 항목에 **장치 수준 비밀번호**를 설정합니다. + +3. 특정 사용자, 사용자 그룹 또는 모든 사용자와 주소록을 공유합니다. + +4. 사용자가 RustDesk 클라이언트에 로그인하고 **주소록** 탭을 엽니다. + +5. 사용자가 공유 주소록을 선택하고 장치 카드를 클릭합니다. + +![클라이언트에서 공유 주소록의 장치 카드 클릭](/docs/en/self-host/rustdesk-server-pro/address-book/images/click-peer-card.png) + +{{% notice warning %}} +공유 비밀번호는 해당 공유 주소록에서 장치 카드를 클릭하거나 드롭다운 메뉴를 사용하여 연결할 때만 사용됩니다. 다른 장치 탭, ID 입력란 옆의 **연결** 버튼, 또는 다른 공유 주소록에서 연결할 때는 사용되지 않습니다. +{{% /notice %}} + +## 공유 주소록 권한 + +| 권한 | 사용자가 할 수 있는 작업 | +| --- | --- | +| **읽기 전용** | 장치와 태그를 볼 수 있고, 비밀번호를 사용할 수 있습니다. | +| **읽기/쓰기** | 장치와 태그를 편집할 수 있습니다. | +| **모든 권한** | 주소록을 다시 공유하거나 삭제하거나 이름을 변경할 수 있습니다. | + +동일한 사용자에게 여러 규칙이 적용되는 경우 우선순위는 다음과 같습니다. + +1. 사용자 +2. 그룹 +3. 모든 사용자 + +예를 들어 **모든 사용자**가 읽기 전용이더라도 특정 사용자에게 모든 권한이 부여되어 있으면, 해당 사용자는 모든 권한을 갖습니다. + +![주소록 공유 권한](/docs/en/self-host/rustdesk-server-pro/address-book/images/share-list.png) + +![웹 콘솔의 공유 주소록 권한](/docs/en/self-host/rustdesk-server-pro/address-book/images/user1-permission.png) + +## 웹 콘솔 + +### 공유 주소록 만들기 또는 편집 + +**주소록 > 공유**에서 이름, 선택 사항인 메모, 선택 사항인 **기본 공유 비밀번호**를 지정하여 공유 주소록을 만듭니다. 이것이 주소록 수준 비밀번호입니다. + +![기본 공유 비밀번호로 공유 주소록 만들기](/docs/en/self-host/rustdesk-server-pro/address-book/images/create-shared-address-book.png) + +### 장치 및 비밀번호 추가 + +장치는 ID로 직접 추가하거나 Server Pro 장치 목록에서 가져올 수 있습니다. 각 항목에 별칭, 태그, 메모를 설정할 수 있으며, 공유 주소록의 경우 장치 수준 비밀번호를 설정할 수 있습니다. + +![공유 주소록에 장치 추가](/docs/en/self-host/rustdesk-server-pro/address-book/images/import-device.png) + +![장치](/docs/en/self-host/rustdesk-server-pro/address-book/images/web-console-addressbook-devices.png) + +![공유 주소록의 장치 편집](/docs/en/self-host/rustdesk-server-pro/address-book/images/web-console-edit-device.png) + +### 태그 및 필터링 + +태그로 장치를 정리하고 필터링할 수 있습니다. `Untagged`는 태그가 없는 장치를 필터링합니다. **교집합으로 필터링**을 켜면 선택한 모든 태그와 일치하는 장치만 표시됩니다. + +### 휴지통 + +주소록에서 장치를 삭제하면 해당 항목이 그 주소록의 휴지통으로 이동합니다. RustDesk Server Pro에서 장치 자체가 삭제되지는 않습니다. + +## 공유 비밀번호 동작 + +| 비밀번호 수준 | 우선순위 | +| --- | --- | +| 장치 수준 비밀번호 | 장치 항목에 비밀번호가 설정되어 있으면 먼저 사용됩니다. | +| 주소록 수준 비밀번호 | 장치 항목에 비밀번호가 없을 때 사용됩니다. | + +두 비밀번호가 모두 설정되지 않은 경우 사용자는 평소대로 연결하며, 비밀번호를 직접 입력해야 할 수 있습니다. 웹 콘솔의 비밀번호 열에는 비밀번호 설정 여부만 표시됩니다. + +## RustDesk 클라이언트 + +로그인한 후 주소록 선택기를 사용하여 **내 주소록**과 공유 주소록 사이를 전환합니다. 공유 주소록의 경우 클라이언트에 현재 사용자의 권한이 표시됩니다. + +![RustDesk 클라이언트의 주소록 선택기](/docs/en/self-host/rustdesk-server-pro/address-book/images/client-address-book-selector.png) + +![읽기 전용 주소록](/docs/en/self-host/rustdesk-server-pro/address-book/images/read-only-address-book.png) + +### 클라이언트에서 편집 + +쓰기 권한이 있는 사용자는 ID 추가, 태그 추가, 별칭 편집, 태그 편집, 메모 편집, 공유 비밀번호 설정, 항목 삭제를 할 수 있습니다. + +![RustDesk 클라이언트의 주소록 장치 메뉴 1](/docs/en/self-host/rustdesk-server-pro/address-book/images/client-address-book-device-menu1.png) + +![RustDesk 클라이언트의 ID 추가](/docs/en/self-host/rustdesk-server-pro/address-book/images/client-add-id.png) + +![RustDesk 클라이언트의 주소록 장치 메뉴 2](/docs/en/self-host/rustdesk-server-pro/address-book/images/client-address-book-device-menu2.png) + +![RustDesk 클라이언트의 비밀번호 변경](/docs/en/self-host/rustdesk-server-pro/address-book/images/client-change-password.png) + +## 배포 사전 설정 + +RustDesk 클라이언트 구성으로 주소록 할당을 미리 설정할 수 있습니다. + +- `preset-address-book-name` +- `preset-address-book-tag` +- `preset-address-book-alias` +- `preset-address-book-password` +- `preset-address-book-note` + +`preset-address-book-alias`, `preset-address-book-password`, `preset-address-book-note`는 RustDesk 클라이언트 1.4.3 이상 및 RustDesk Server Pro 1.6.6 이상이 필요합니다. + +자세한 내용은 [고급 클라이언트 구성](/docs/en/self-host/client-configuration/advanced-settings/#preset-address-book-name--preset-address-book-tag--preset-address-book-alias--preset-address-book-password--preset-address-book-note)을 참조하십시오. + +## 관련 설정 + +| 설정 | 위치 | 효과 | +| --- | --- | --- | +| **관리자가 아닌 사용자가 다른 그룹에 주소록을 공유하도록 허용** | **설정 > 기타** | 관리자가 아닌 사용자가 다른 사용자 그룹에 주소록을 공유할 수 있습니다. | +| **주소록 비활성화** | **사용자 지정 클라이언트** | 생성된 사용자 지정 클라이언트에서 주소록을 숨기거나 비활성화합니다. | + +## 문제 해결 + +### 비밀번호 오류 + +공유 주소록에 저장된 비밀번호는 제어하는 쪽의 RustDesk 클라이언트에서 사용됩니다. 이 비밀번호가 피제어 장치에 설정되는 것은 아닙니다. 피제어 장치의 비밀번호는 해당 장치에서 **설정 > 보안 > 비밀번호**를 통해 설정하십시오. + +공유 비밀번호를 사용하려면 해당 공유 주소록에서 장치 카드를 클릭하여 연결하십시오. 다른 주소록, 다른 장치 탭, 또는 ID 입력란 옆의 **연결** 버튼으로 연결하면 이 주소록의 공유 비밀번호가 사용되지 않습니다. diff --git a/hugo.yaml b/hugo.yaml index 7655e646..db34daa6 100644 --- a/hugo.yaml +++ b/hugo.yaml @@ -28,11 +28,14 @@ enableRobotsTXT: true enableGitInfo: true # Sitemap configuration +# changefreq and priority are deliberately unset: Google and Bing ignore both, +# and a site-wide constant priority carries no signal even for parsers that read it. sitemap: - changefreq: "weekly" - priority: 0.8 filename: "sitemap.xml" +# No page uses tags or categories, so Hugo's taxonomy pages would be empty. +disableKinds: ["taxonomy", "term"] + # Configure static file handling for absolute paths staticDir: ["static"] diff --git a/layouts/sitemap.xml b/layouts/sitemap.xml new file mode 100644 index 00000000..43b6f843 --- /dev/null +++ b/layouts/sitemap.xml @@ -0,0 +1,25 @@ +{{- printf "" "1.0" "utf-8" "yes" | safeHTML }} + + {{- range .Pages }} + {{- with .Sitemap.Disable }}{{ continue }}{{ end }} + + {{ .Permalink }} + {{- with .Lastmod }} + {{ .Format "2006-01-02T15:04:05-07:00" }} + {{- end }} + {{- if .IsTranslated }} + {{- range .AllTranslations }} + {{- /* Lang, not LanguageCode: the site-wide languageCode is en-US, which would target + English at the US only and clash with the bare codes used by every other language. */}} + + {{- end }} + {{- /* x-default must point at defaultContentLanguage (en, per hugo.yaml). */}} + {{- range .AllTranslations }} + {{- if eq .Language.Lang "en" }} + + {{- end }} + {{- end }} + {{- end }} + + {{- end }} + diff --git a/v3/src/pages/robots.txt.ts b/v3/src/pages/robots.txt.ts index c65f349b..ff5968b3 100644 --- a/v3/src/pages/robots.txt.ts +++ b/v3/src/pages/robots.txt.ts @@ -1,26 +1,27 @@ import type { APIRoute } from 'astro'; -import { AI_CRAWLER_POLICIES, getSiteOrigin } from '~/utils/seo'; +import { BLOCKED_CRAWLERS, SITEMAP_PATHS, getSiteOrigin } from '~/utils/seo'; export const prerender = true; export const GET: APIRoute = ({ site }) => { const origin = getSiteOrigin(site); const lines = [ + '# RustDesk - robots.txt', + `# ${origin}`, + '', + '# Every crawler is welcome, AI crawlers included. A bot with no group of its own', + '# falls back to this group, so new ones never need an entry here.', 'User-agent: *', 'Allow: /', 'Disallow: /success', 'Disallow: /cancel', '', - ...AI_CRAWLER_POLICIES.flatMap((policy) => [ - `User-agent: ${policy.name}`, - `Allow: ${policy.allow}`, - 'Disallow: /success', - 'Disallow: /cancel', - '', - ]), - `Sitemap: ${origin}/sitemap-index.xml`, + '# Bulk scrapers that feed training corpora and send back no readers.', + ...BLOCKED_CRAWLERS.flatMap((name) => [`User-agent: ${name}`, 'Disallow: /', '']), + ...SITEMAP_PATHS.map((path) => `Sitemap: ${origin}${path}`), `Host: ${new URL(origin).host}`, + '', ]; return new Response(lines.join('\n'), { diff --git a/v3/src/utils/seo.ts b/v3/src/utils/seo.ts index 63ae827c..d638254b 100644 --- a/v3/src/utils/seo.ts +++ b/v3/src/utils/seo.ts @@ -122,15 +122,12 @@ export const shouldIndexUtilityPage = (pathname: string) => { return !['success', 'cancel', 'utility'].includes(kind); }; -export const AI_CRAWLER_POLICIES = [ - { name: 'GPTBot', allow: '/' }, - { name: 'ChatGPT-User', allow: '/' }, - { name: 'PerplexityBot', allow: '/' }, - { name: 'ClaudeBot', allow: '/' }, - { name: 'anthropic-ai', allow: '/' }, - { name: 'Google-Extended', allow: '/' }, - { name: 'Bingbot', allow: '/' }, -]; +// Crawlers are allowed by the `User-agent: *` group in robots.txt, so AI crawlers need no +// entry of their own. Only bots we want to keep out are named here. +export const BLOCKED_CRAWLERS = ['CCBot', 'img2dataset']; + +// The /docs section is a separate Hugo build, so its sitemap is not part of the Astro one. +export const SITEMAP_PATHS = ['/sitemap-index.xml', '/docs/sitemap.xml']; export const getImportantSiteLinks = () => [ { label: 'Homepage', url: `${SITE_URL}/` }, diff --git a/v3/vendor/integration/index.ts b/v3/vendor/integration/index.ts index 9b7b726a..bbf36f8c 100644 --- a/v3/vendor/integration/index.ts +++ b/v3/vendor/integration/index.ts @@ -1,12 +1,9 @@ -import fs from 'node:fs'; -import os from 'node:os'; -import type { AstroConfig, AstroIntegration } from 'astro'; +import type { AstroIntegration } from 'astro'; import configBuilder, { type Config } from './utils/configBuilder'; import loadConfig from './utils/loadConfig'; export default ({ config: _themeConfig = 'src/config.yaml' } = {}): AstroIntegration => { - let cfg: AstroConfig; return { name: 'astrowind-integration', @@ -68,49 +65,6 @@ export default ({ config: _themeConfig = 'src/config.yaml' } = {}): AstroIntegra buildLogger.info(`Astrowind config has been loaded.`); } }, - 'astro:config:done': async ({ config }) => { - cfg = config; - }, - - 'astro:build:done': async ({ logger }) => { - const buildLogger = logger.fork('astrowind'); - buildLogger.info('Updating `robots.txt` with `sitemap-index.xml` ...'); - - try { - const outDir = cfg.outDir; - const publicDir = cfg.publicDir; - const sitemapName = 'sitemap-index.xml'; - const sitemapFile = new URL(sitemapName, outDir); - const robotsTxtFile = new URL('robots.txt', publicDir); - const robotsTxtFileInOut = new URL('robots.txt', outDir); - - const hasIntegration = - Array.isArray(cfg?.integrations) && - cfg.integrations?.find((e) => e?.name === '@astrojs/sitemap') !== undefined; - const sitemapExists = fs.existsSync(sitemapFile); - - if (hasIntegration && sitemapExists) { - const robotsTxt = fs.readFileSync(robotsTxtFile, { encoding: 'utf8', flag: 'a+' }); - const sitemapUrl = new URL(sitemapName, String(new URL(cfg.base, cfg.site))); - const pattern = /^Sitemap:(.*)$/m; - - if (!pattern.test(robotsTxt)) { - fs.writeFileSync(robotsTxtFileInOut, `${robotsTxt}${os.EOL}${os.EOL}Sitemap: ${sitemapUrl}`, { - encoding: 'utf8', - flag: 'w', - }); - } else { - fs.writeFileSync(robotsTxtFileInOut, robotsTxt.replace(pattern, `Sitemap: ${sitemapUrl}`), { - encoding: 'utf8', - flag: 'w', - }); - } - } - // eslint-disable-next-line @typescript-eslint/no-unused-vars - } catch (error) { - /* empty */ - } - }, }, }; };