Search...Search plugins and themes...
⌘K
Sign in
  • Get started
  • Download
  • Pricing
  • Enterprise
  • Account
  • Obsidian
  • Overview
  • Sync
  • Publish
  • Canvas
  • Mobile
  • Web Clipper
  • CLI
  • Learn
  • Help
  • Developers
  • Changelog
  • About
  • Roadmap
  • Blog
  • Resources
  • System status
  • License overview
  • Terms of service
  • Privacy policy
  • Security
  • Community
  • Plugins
  • Join the community
  • Discord
  • Forum / 中文论坛
  • Merch store
  • Brand guidelines
Follow us
DiscordTwitterBlueskyThreadsMastodonYouTubeGitHub
© 2026 Obsidian

Global Proxy

windingblackwindingblack14k downloads

Configure network proxies for users in areas with restricted networks.

Add to Obsidian
  • Overview
  • Scorecard
  • Updates6

Global Proxy is an Obsidian plugin that makes it easy to configure network proxies and use these proxies throughout Obsidian. Currently supported proxy types include socks, http, and https. It may be needed by users in areas with restricted networks.

How to Use

  • Fill in the input boxes with the corresponding proxy address. If all the proxies are invalid, all requests will be direct without using a proxy. If both socks and http/https proxies are set, they may be used. The plugin will use the socks proxy first, and if it fails, it will use the http/https proxy. If the http/https proxy fails, the request will be direct.
  • A few plugins will maintain their own network connections that do not use the default session of Obsidian, so their traffic won't be proxied. However you can declare a Plugin Token to proxy the network traffic of one of these plugins.
  • If blacklist is set, the plugin will not use the proxy for the specified URLs. The bypass list is a comma separated list of rules. The rules are described in the Blacklist section.

Setting Tab

Plugin Token

Here are some Plugin Token examples for popular Obsidian plugins.

Repo Plugin Token
Obsidian-Surfing persist:surfing-vault-${appId}
media-extended persist:mx-player-${appId}

Blacklist

The Bypass List is a comma separated list of rules described below:

  • [ URL_SCHEME "://" ] HOSTNAME_PATTERN [ ":" <port> ] Match all hostnames that match the pattern HOSTNAME_PATTERN. Examples: foobar.com, *foobar.com, *.foobar.com, *foobar.com:99, https://x.\*.y.com:99

  • "." HOSTNAME_SUFFIX_PATTERN [ ":" PORT ] Match a particular domain suffix. Examples: .google.com, .com, http://.google.com

  • [ SCHEME "://" ] IP_LITERAL [ ":" PORT ] Match URLs which are IP address literals. Examples: 127.0.1, [0:0::1], [::1], http://[::1]:99

  • IP_LITERAL "/" PREFIX_LENGTH_IN_BITS Match any URL that is to an IP literal that falls between the given range. IP range is specified using CIDR notation. Examples: 192.168.1.1/16, fefe:13::abc/33.

  • <local> Match local addresses. The meaning of <local> is whether the host matches one of: 127.0.0.1, ::1, localhost.

83%
HealthGood
ReviewSatisfactory
About
Configure global SOCKS, HTTP, and HTTPS proxies to route Obsidian network requests, automatically falling back from SOCKS to HTTP/HTTPS to direct when a proxy fails. Declare Plugin Tokens to proxy plugins with their own connections and set a comma-separated bypass list to exclude URLs.
UtilitiesIntegrationsDevelopers
Details
Current version
1.0.4
Last updated
11 months ago
Created
2 years ago
Updates
6 releases
Downloads
14k
Compatible with
Obsidian 0.15.0+
License
MIT
Report bugRequest featureReport plugin
Sponsor
Buy Me a Coffee
Author
windingblackwindingblack
github.com/windingblack
GitHubwindingblack
  1. Community
  2. Plugins
  3. Utilities
  4. Global Proxy

Related plugins

BRAT

Easily install a beta version of a plugin for testing.

Terminal

Integrate consoles, shells, and terminals.

Local REST API

Unlock your automation needs by interacting with your notes over a secure REST API.

AI Providers

A hub for setting AI providers (OpenAI-like, Ollama and more) in one place.

Maps

Adds a map layout to bases so you can display notes as an interactive map view.

Zotero Integration

Insert and import citations, bibliographies, notes, and PDF annotations from Zotero.

Smart Composer

AI chat with note context, smart writing assistance, and one-click edits for your vault.

LanguageTool Integration

advanced spell/grammar checks with the help of language-tool.

Readwise Official

Sync highlights from Readwise to your vault.

MCP Tools

Securely connect Claude Desktop to your vault with semantic search, templates, and file management capabilities.