Skip to content

docs: add guide for Proxy-Wasm C++ integration#294

Merged
hydai merged 1 commit into
WasmEdge:mainfrom
blackdragoon26:main
May 18, 2026
Merged

docs: add guide for Proxy-Wasm C++ integration#294
hydai merged 1 commit into
WasmEdge:mainfrom
blackdragoon26:main

Conversation

@blackdragoon26
Copy link
Copy Markdown
Contributor

Explanation

This PR adds a new deployment guide explaining how to use WasmEdge as the runtime engine inside network proxies using the Proxy-Wasm standard, based on https://github.com/blackdragoon26/wasmedge_proxy_wasm_demo
For a non-developer, this means we are providing instructions on how to use WasmEdge to securely filter and modify internet traffic flowing through cloud infrastructure. This represents a new addition to the existing deployment documentation.

Related issue

Fixes WasmEdge/WasmEdge#1439

What type of PR is this

/kind documentation

Proposed Changes

  • Added docs/develop/deploy/proxy-wasm.md to the Kubernetes deployment section.
  • Documented the architecture of a standalone Proxy-Wasm host integrating with WasmEdge.
  • Provided an automated Quick Start guide pointing to the community demo repository.
  • Added comprehensive manual build instructions, including critical compiler flag overrides (--target=wasm32-wasip1) required for compatibility between the proxy-wasm SDK and the modern wasi-sdk-32 toolchain.

@blackdragoon26
Copy link
Copy Markdown
Contributor Author

Hihi CodeOwners @hydai @juntao @alabulei1 ,
Kindly review me PR and just dropping a quick suggestion regarding the standalone demo repository linked in this guide: wasmedge_proxy_wasm_demo.

Currently, this lives under my personal account. To ensure long-term CI reliability, prevent future broken links, and keep community maintenance centralized, it might be beneficial to eventually migrate this repository into the official WasmEdge organization.
Let me know your thoughts on this!

Comment thread docs/develop/deploy/proxy-wasm.md Outdated
@blackdragoon26 blackdragoon26 force-pushed the main branch 2 times, most recently from cbc67eb to cdad164 Compare April 27, 2026 17:46
@blackdragoon26 blackdragoon26 requested a review from hydai April 27, 2026 17:47
@blackdragoon26
Copy link
Copy Markdown
Contributor Author

@hydai Kindly review the PR.

@blackdragoon26
Copy link
Copy Markdown
Contributor Author

@hydai Kindly review the PR.

@hydai pinging for the above.

@blackdragoon26
Copy link
Copy Markdown
Contributor Author

Hihi @hydai @juntao @alabulei1 , gentle reminder, for this PR review.

@blackdragoon26
Copy link
Copy Markdown
Contributor Author

@hydai pinging for the above.

@hydai
Copy link
Copy Markdown
Member

hydai commented May 18, 2026

Your CI check failed. You should fix it first.

@blackdragoon26
Copy link
Copy Markdown
Contributor Author

FIxed it @hydai ,
Please approve the workflows.

Signed-off-by: blackdragoon26 <sankalp.jha9643@gmail.com>
@hydai hydai merged commit 2621205 into WasmEdge:main May 18, 2026
6 checks passed
@hydai
Copy link
Copy Markdown
Member

hydai commented May 18, 2026

Thanks.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

A demo for proxy-wasm

2 participants