Title: WebFinger
Author: Matthias Pfefferle
Published: <strong>2010 年 4 月 20 日</strong>
Last modified: 2026 年 6 月 16 日

---

搜尋外掛

![](https://ps.w.org/webfinger/assets/banner-772x250.jpg?rev=2815154)

![](https://ps.w.org/webfinger/assets/icon-256x256.png?rev=2815154)

# WebFinger

 由 [Matthias Pfefferle](https://profiles.wordpress.org/pfefferle/) 開發

[下載](https://downloads.wordpress.org/plugin/webfinger.4.0.1.zip)

 * [詳細資料](https://tw.wordpress.org/plugins/webfinger/#description)
 * [使用者評論](https://tw.wordpress.org/plugins/webfinger/#reviews)
 *  [安裝方式](https://tw.wordpress.org/plugins/webfinger/#installation)
 * [開發資訊](https://tw.wordpress.org/plugins/webfinger/#developers)

 [技術支援](https://wordpress.org/support/plugin/webfinger/)

## 外掛說明

WebFinger allows you to be discovered on the web using an identifier like `you@yourdomain.
com` — similar to how email works, but for your online identity.

**Why is this useful?**

 * **Fediverse & Mastodon:** WebFinger is essential for federation. It allows Mastodon
   and other ActivityPub-powered platforms to find and follow your WordPress site.
 * **Decentralized Identity:** People can look you up using your WordPress domain,
   making your site the canonical source for your online identity.
 * **Works with other plugins:** This plugin provides the foundation that other 
   plugins (like the ActivityPub plugin) build upon.

**How it works:**

When someone searches for `@you@yourdomain.com` on Mastodon or another federated
service, their server asks your WordPress site: “Who is this person?” WebFinger 
answers that question by providing information about you and links to your profiles.

**Technical details:**

WebFinger is an open standard ([RFC 7033](http://tools.ietf.org/html/rfc7033)) that
enables discovery of information about people and resources on the internet. It 
works by responding to requests at `/.well-known/webfinger` on your domain.

## 安裝方式

### From WordPress.org (recommended)

 1. Go to **Plugins  Add New** in your WordPress admin
 2. Search for “webfinger”
 3. Click **Install Now**, then **Activate**
 4. Make sure pretty permalinks are enabled (**Settings  Permalinks** — select any 
    option except “Plain”)
 5. Visit **Tools  Site Health** to verify everything is working

### Manual Installation

 1. Download the plugin from [WordPress.org](https://wordpress.org/plugins/webfinger/)
    or [GitHub](https://github.com/pfefferle/wordpress-webfinger/releases)
 2. Upload the `webfinger` folder to `/wp-content/plugins/`
 3. Activate the plugin in **Plugins  Installed Plugins**
 4. Enable pretty permalinks if not already active
 5. Check **Tools  Site Health** to confirm the setup

## 常見問題集

### How do I customize my WebFinger identifier?

Go to **Users  Profile** in your WordPress admin and scroll down to the “WebFinger”
section. There you can set a custom identifier (the part before the @) and see all
your WebFinger aliases.

### How do I check if WebFinger is working?

Visit **Tools  Site Health** in your WordPress admin. The plugin adds checks that
verify your WebFinger endpoint is accessible and properly configured. If there are
any issues, you’ll see guidance on how to fix them.

### Does this work with Mastodon?

Yes! WebFinger is the standard that Mastodon and other Fediverse platforms use to
discover users. When someone searches for `@you@yourdomain.com`, WebFinger tells
them where to find your profile.

### Do I need pretty permalinks?

Yes. WebFinger requires pretty permalinks to be enabled. Go to **Settings  Permalinks**
and select any option other than “Plain”.

### For developers: How do I add custom data to the WebFinger response?

Use the `webfinger_data` filter to add your own links or properties:

    ```
    add_filter( 'webfinger_data', function( $data ) {
      $data['links'][] = array(
        'rel'  => 'http://example.com/rel/profile',
        'href' => 'http://example.com/profile',
        'type' => 'text/html',
      );
      return $data;
    } );
    ```

### For developers: How do I add alternate output formats?

Use the `webfinger_render` action to output custom formats (like XRD):

    ```
    add_action( 'webfinger_render', function( $webfinger ) {
      // Set custom headers and output your format
      // ...
      exit;
    }, 5 );
    ```

See [https://github.com/pfefferle/wordpress-webfinger-legacy](https://github.com/pfefferle/wordpress-webfinger-legacy)
for a complete example.

### Where can I learn more about WebFinger?

 * WebFinger specification: [RFC 7033](http://tools.ietf.org/html/rfc7033)
 * Community resources: [http://webfinger.net](http://webfinger.net)

## 使用者評論

![](https://secure.gravatar.com/avatar/2f88c80005db8d6bc27301a3023cc557e267ae64b6ccd8dd5773120511910312?
s=60&d=retro&r=g)

### 󠀁[Does as expected.](https://wordpress.org/support/topic/does-as-expected-6/)󠁿

 [Khürt Williams](https://profiles.wordpress.org/khurtwilliams/) 2023 年 11 月 11
日

I installed Webfinger and typed in the domain for my website into Mastodon instance
photog.social. Mastodon immediately found ky ActivityPub endpoints.

![](https://secure.gravatar.com/avatar/b52b9342fc917a4d5770bdd39e628f8b1f24dbef225b7803cda3c0ced245ffeb?
s=60&d=retro&r=g)

### 󠀁[No config easy way to add webfinger for your existing users](https://wordpress.org/support/topic/no-config-easy-way-to-add-webfinger-for-your-existing-users/)󠁿

 [ffpf](https://profiles.wordpress.org/ffpf/) 2023 年 1 月 20 日

Adding this plugin adds handling for the WebFinger protocol for your existing users.
For example, when someone searches for you on Mastodon, your server will be queried
for accounts using an endpoint that looks like this: GET ${MASTODON_DOMAIN}/.well-
known/webfinger?resource=acct:${MASTODON_USER}@${MASTODON_DOMAIN} So, if you have
a WordPress blog with the URL blog.domain and that blog has a user (you can see 
users in the Users admin panel) named user1, then the webfinger URL for that user
would be: blog.domain/.well-known/webfinger?resource=acct:user1@blog.domain This
plugin implements handling for such requests for any user on the WordPress site 
without any additional configuration.

![](https://secure.gravatar.com/avatar/f5a3d6d6ce8cc462ba390139eadfe6da39a8de6dc1db4bc074094027c591386a?
s=60&d=retro&r=g)

### 󠀁[Didn’t work.](https://wordpress.org/support/topic/didnt-work-370/)󠁿

 [sunriselane](https://profiles.wordpress.org/sunriselane/) 2023 年 1 月 15 日 1
則留言

There’s no admin panel and the documentation isn’t clear about how to configure 
the plugin.

 [ 閱讀全部 3 則使用者評論 ](https://wordpress.org/support/plugin/webfinger/reviews/)

## 參與者及開發者

以下人員參與了開源軟體〈WebFinger〉的開發相關工作。

參與者

 *   [ Matthias Pfefferle ](https://profiles.wordpress.org/pfefferle/)
 *   [ Will Norris ](https://profiles.wordpress.org/willnorris/)

[將〈WebFinger〉外掛本地化為台灣繁體中文版](https://translate.wordpress.org/projects/wp-plugins/webfinger)

### 對開發相關資訊感興趣？

任何人均可[瀏覽程式碼](https://plugins.trac.wordpress.org/browser/webfinger/)、查看
[SVN 存放庫](https://plugins.svn.wordpress.org/webfinger/)，或透過 [RSS](https://plugins.trac.wordpress.org/log/webfinger/?limit=100&mode=stop_on_copy&format=rss)
訂閱[開發記錄](https://plugins.trac.wordpress.org/log/webfinger/)。

## 變更記錄

Project maintained on github at [pfefferle/wordpress-webfinger](https://github.com/pfefferle/wordpress-webfinger).

### 4.0.1

 * Fixed: Handle WP_Error objects in `filter_by_rel` to prevent errors when WebFinger
   lookup fails

### 4.0.0

 * Added: Site Health integration to check your WebFinger setup status directly 
   in WordPress
 * Added: User profile settings to customize your WebFinger identifier
 * Added: Verification links to easily test your WebFinger aliases
 * Improved: Security hardening for URI parsing and input validation
 * Improved: Modernized codebase for PHP 7.2+ with namespace support
 * Improved: Better organized code structure with separate classes
 * Updated: Development infrastructure with GitHub Actions for automated testing

### 3.2.7

 * Added: better output escaping
 * Fixed: stricter queries

### 3.2.6

 * remove E-Mail address

### 3.2.5

 * fix typo

### 3.2.4

 * update requirements

### 3.2.3

 * fixed `acct` scheme for discovery

### 3.2.2

 * fixed typo (thanks @ivucica)
 * use `acct` as default scheme

### 3.2.1

 * make `acct` protocol optional

### 3.2.0

 * global refactoring

### 3.1.6

 * added `user_nicename` as resource
 * fixed WordPress coding standard issues

### 3.1.5

 * fixed PHP warning

### 3.1.4

 * updated requirements

### 3.1.3

 * add support for the ‘aim’, ‘ymsgr’ and ‘acct’ protocol

### 3.1.2

 * fixed the legacy code
 * added feeds

### 3.1.1

 * fixed ‘get_user_by_various’ function

### 3.1.0

 * Added WebFinger legacy plugin, because the legacy version is still very popular
   and used by for example OStatus (Mastodon, Status.NET and GNU Social)
 * Added Webfinger for posts support

### 3.0.3

 * composer support
 * compatibility updates

### 3.0.2

 * `get_avatar_url` instead of custom code
 * some small code improvements
 * nicer PHP-docs

### 3.0.1

 * updated version informations
 * support the WordPress Coding Standard

### 3.0.0

 * added correct error-responses
 * remove legacy support for XRD and host-meta (props to Will Norris)

### 2.0.1

 * small bugfix

### 2.0.0

 * complete refactoring
 * removed simple-web-discovery
 * more filters and actions
 * works without /.well-known/ plugin

### 1.4.0

 * small fixes
 * added “webfinger” as well-known uri

### 1.3.1

 * added “rel”-filter (work in progress)
 * added more aliases

### 1.3

 * added host-meta resource feature (see latest spec)

### 1.2

 * added 404 http error if user doesn’t exist
 * added jrd discovery for host-meta

### 1.1

 * fixed an odd problem with lower WordPress versions
 * added support for the https://wordpress.org/extend/plugins/extended-profile/ (
   thanks to Singpolyma)

### 1.0.1

 * api improvements

### 1.0

 * basic simple-seb-discovery
 * json support
 * some small improvements

### 0.9.1

 * some changes to support http://unhosted.org

### 0.9

 * OStatus improvements
 * Better uri handling
 * Identifier overview (more to come)
 * Added filters
 * Added functions to get a users webfingers

### 0.7

 * Added do_action param (for future OStatus plugin)
 * Author-Url as Webfinger-Identifier

### 0.5

 * Initial release

## 社群版外掛

這個外掛由社群人員開發及提供技術支援。 [參與這個外掛專案](https://github.com/pfefferle/wordpress-webfinger)

## 中繼資料

 *  版本 **4.0.1**
 *  最後更新 **1 個月前**
 *  啟用安裝數 **1,000+**
 *  WordPress 版本需求 ** 4.2 或更新版本 **
 *  已測試相容的 WordPress 版本 **7.0.2**
 *  PHP 版本需求 ** 7.4 或更新版本 **
 *  語言
 * [English (US)](https://wordpress.org/plugins/webfinger/)
 * 標籤:
 * [activitypub](https://tw.wordpress.org/plugins/tags/activitypub/)[discovery](https://tw.wordpress.org/plugins/tags/discovery/)
   [jrd](https://tw.wordpress.org/plugins/tags/jrd/)[ostatus](https://tw.wordpress.org/plugins/tags/ostatus/)
   [Webfinger](https://tw.wordpress.org/plugins/tags/webfinger/)
 *  [進階檢視](https://tw.wordpress.org/plugins/webfinger/advanced/)

## 評分

 3.7 星，滿分為 5 星

 *  [  2 個 5 星使用者評論     ](https://wordpress.org/support/plugin/webfinger/reviews/?filter=5)
 *  [  0 個 4 星使用者評論     ](https://wordpress.org/support/plugin/webfinger/reviews/?filter=4)
 *  [  0 個 3 星使用者評論     ](https://wordpress.org/support/plugin/webfinger/reviews/?filter=3)
 *  [  0 個 2 星使用者評論     ](https://wordpress.org/support/plugin/webfinger/reviews/?filter=2)
 *  [  1 個 1 星使用者評論     ](https://wordpress.org/support/plugin/webfinger/reviews/?filter=1)

[Your review](https://wordpress.org/support/plugin/webfinger/reviews/#new-post)

[查看全部使用者評論](https://wordpress.org/support/plugin/webfinger/reviews/)

## 參與者

 *   [ Matthias Pfefferle ](https://profiles.wordpress.org/pfefferle/)
 *   [ Will Norris ](https://profiles.wordpress.org/willnorris/)

## 技術支援

使用者可在技術支援論壇提出意見反應或使用問題。

 [檢視技術支援論壇](https://wordpress.org/support/plugin/webfinger/)

## 贊助

想要支援這個外掛的發展嗎？

 [ 贊助這個外掛 ](https://notiz.blog/donate/)