nodejs-argo is an Argo tunnel deployment tool designed for Node.js PaaS platforms and toy platforms.
The tool addresses the need to deploy proxy nodes on constrained hosting environments by leveraging Argo tunnels as the underlying transport mechanism. It supports multiple proxy protocols including VLESS, VMess, and Trojan, with optional direct connection protocols such as Socks5, Hysteria2, and Reality. The deployment model is lightweight: on toy platforms, only index.js and package.json need to be uploaded, while PaaS platforms requiring Docker can use the provided Dockerfile. The tool integrates Nezha probe functionality for node monitoring, with automatic TLS enablement when the Nezha port matches specific values.
Adoption suits developers deploying proxy infrastructure on Node.js hosting platforms where traditional VPS deployment is unavailable or impractical. The tool operates in two modes: temporary tunnels when ARGO_DOMAIN and ARGO_AUTH variables are omitted, or fixed tunnels when these credentials are provided. Configuration is managed through environment variables covering subscription upload URLs, node UUIDs, monitoring credentials, and traffic optimization settings like CF IP selection. The project explicitly restricts commercial use and public proxy operation, stating these are prohibited under its licensing terms.
Development activity shows ongoing maintenance with support for multiple deployment methods including systemd services, PM2, screen, and tmux for background operation. The project provides npm package distribution alongside direct GitHub access, with documented update procedures and environment variable configuration options. Issue feedback is actively solicited through both GitHub and Telegram channels.
