devtunnel-cli 3.0.35 โ 3.0.37
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +102 -3
- package/package.json +3 -3
package/README.md
CHANGED
|
@@ -6,7 +6,20 @@
|
|
|
6
6
|
[](https://github.com/maiz-an/DevTunnel-CLI)
|
|
7
7
|
[](https://www.npmjs.com/package/devtunnel-cli)
|
|
8
8
|
|
|
9
|
-
๐ **Website:** [
|
|
9
|
+
๐ **Website:** [devtunnel-cli.vercel.app](https://devtunnel-cli.vercel.app) | ๐ฆ **npm:** [devtunnel-cli](https://www.npmjs.com/package/devtunnel-cli) | ๐ป **GitHub:** [maiz-an/DevTunnel-CLI](https://github.com/maiz-an/DevTunnel-CLI)
|
|
10
|
+
|
|
11
|
+
---
|
|
12
|
+
|
|
13
|
+
## ๐ฏ Purpose & Scope
|
|
14
|
+
|
|
15
|
+
DevTunnel-CLI is designed for **DEVELOPMENT**, **TESTING**, **DEMOS**, and **WEBHOOK DEBUGGING**. It provides fast, frictionless access to your local dev servers from anywhere.
|
|
16
|
+
|
|
17
|
+
**This tool is NOT intended for:**
|
|
18
|
+
- Production environments
|
|
19
|
+
- Long-lived public services
|
|
20
|
+
- Hosting production traffic
|
|
21
|
+
|
|
22
|
+
DevTunnel-CLI is built for developers who need instant, temporary public URLs to share work-in-progress, test on mobile devices, demo features to clients, or debug webhooks from third-party services.
|
|
10
23
|
|
|
11
24
|
---
|
|
12
25
|
|
|
@@ -83,6 +96,92 @@ devtunnel-cli
|
|
|
83
96
|
|
|
84
97
|
---
|
|
85
98
|
|
|
99
|
+
## ๐ Security & Access Model
|
|
100
|
+
|
|
101
|
+
DevTunnel-CLI intentionally **does NOT use authentication or access control**. This is a deliberate design choice to ensure fast, frictionless development workflows.
|
|
102
|
+
|
|
103
|
+
**How Access Works:**
|
|
104
|
+
- Anyone with the generated temporary URL can access the tunnel until it is stopped
|
|
105
|
+
- No login, password, or identity verification required
|
|
106
|
+
- Access is limited by **possession of the URL only**
|
|
107
|
+
|
|
108
|
+
**Why This Design?**
|
|
109
|
+
- **Speed**: Get public URLs instantly without authentication setup
|
|
110
|
+
- **Simplicity**: Zero configuration โ just run and share
|
|
111
|
+
- **Friction-free collaboration**: Share with teammates without managing accounts or permissions
|
|
112
|
+
|
|
113
|
+
**Temporary URL Behavior:**
|
|
114
|
+
- URLs are **short-lived** and **unlisted**
|
|
115
|
+
- URLs are **destroyed** when the tunnel stops
|
|
116
|
+
- New random URLs are generated each time you run DevTunnel-CLI
|
|
117
|
+
- URLs are not indexed by search engines
|
|
118
|
+
|
|
119
|
+
**Best Practices:**
|
|
120
|
+
- Only share URLs with trusted collaborators
|
|
121
|
+
- Stop the tunnel when not in use
|
|
122
|
+
- Never expose sensitive data or production databases through DevTunnel-CLI
|
|
123
|
+
- Use for development and testing only
|
|
124
|
+
|
|
125
|
+
---
|
|
126
|
+
|
|
127
|
+
## โ ๏ธ Limitations
|
|
128
|
+
|
|
129
|
+
DevTunnel-CLI has intentional limitations that make it ideal for development but unsuitable for other use cases:
|
|
130
|
+
|
|
131
|
+
### No Authentication or Access Control
|
|
132
|
+
- **By design**: No identity-based access control
|
|
133
|
+
- **By design**: No user-level permission management
|
|
134
|
+
- **By design**: No password protection or login system
|
|
135
|
+
- Anyone with the URL can access your tunnel
|
|
136
|
+
|
|
137
|
+
### Not Suitable For
|
|
138
|
+
- โ Production environments
|
|
139
|
+
- โ Long-lived public services
|
|
140
|
+
- โ Hosting production traffic
|
|
141
|
+
- โ Sensitive data exposure
|
|
142
|
+
- โ Public-facing applications
|
|
143
|
+
|
|
144
|
+
### Perfect For
|
|
145
|
+
- โ
Development and testing
|
|
146
|
+
- โ
Team collaboration and code reviews
|
|
147
|
+
- โ
Mobile device testing
|
|
148
|
+
- โ
Client demos and work-in-progress sharing
|
|
149
|
+
- โ
Webhook debugging with third-party services
|
|
150
|
+
- โ
Temporary public access to localhost
|
|
151
|
+
|
|
152
|
+
### File Size & Streaming Limits
|
|
153
|
+
- โ
Small files (<10MB): Works perfectly
|
|
154
|
+
- โ
Medium files (10-50MB): Works well, may have slight delays
|
|
155
|
+
- โ ๏ธ Large files (>50MB): May timeout depending on connection speed
|
|
156
|
+
- โ ๏ธ Very large files (>100MB): Not recommended for Cloudflare free tier
|
|
157
|
+
|
|
158
|
+
---
|
|
159
|
+
|
|
160
|
+
## ๐ Comparison: DevTunnel-CLI vs. Enterprise Tunnels
|
|
161
|
+
|
|
162
|
+
DevTunnel-CLI is optimized for **speed and simplicity** rather than governance and authentication.
|
|
163
|
+
|
|
164
|
+
| Feature | DevTunnel-CLI | Enterprise Tunnels (e.g., Microsoft Dev Tunnels) |
|
|
165
|
+
|---------|---------------|--------------------------------------------------|
|
|
166
|
+
| **Setup Time** | Instant (0 config) | Requires account, authentication setup |
|
|
167
|
+
| **Authentication** | None (by design) | User-based auth, SSO, identity management |
|
|
168
|
+
| **Access Control** | URL possession only | Fine-grained permissions, user/group policies |
|
|
169
|
+
| **Use Case** | Development, testing, demos | Enterprise dev, governed access, compliance |
|
|
170
|
+
| **Speed** | Instant sharing | May require approval workflows |
|
|
171
|
+
| **Ideal For** | Solo devs, small teams, fast iteration | Large orgs, regulated industries, prod-like envs |
|
|
172
|
+
|
|
173
|
+
**Choose DevTunnel-CLI when:**
|
|
174
|
+
- You need instant, frictionless sharing
|
|
175
|
+
- You're working on non-sensitive development projects
|
|
176
|
+
- Speed and simplicity are priorities
|
|
177
|
+
|
|
178
|
+
**Choose enterprise tunnels when:**
|
|
179
|
+
- You need identity-based access control
|
|
180
|
+
- You're in a regulated or compliance-heavy environment
|
|
181
|
+
- You need audit logs and governance
|
|
182
|
+
|
|
183
|
+
---
|
|
184
|
+
|
|
86
185
|
## ๐ Documentation
|
|
87
186
|
|
|
88
187
|
- [Features](docs/FEATURES.md)
|
|
@@ -114,13 +213,13 @@ MIT License - see [LICENSE](docs/LICENSE)
|
|
|
114
213
|
|
|
115
214
|
## ๐ Search keywords
|
|
116
215
|
|
|
117
|
-
Find this project as: **DevTunnel**, **devtunnel**, **dev-tunnel**, **Dev-Tunnel**, **DevTunnel-CLI**, **devtunnel-cli**, **dev-tunnel-cli**, **Dev-Tunnel-CLI**. npm (install here): [devtunnel-cli](https://www.npmjs.com/package/devtunnel-cli) ยท Docs: [
|
|
216
|
+
Find this project as: **DevTunnel**, **devtunnel**, **dev-tunnel**, **Dev-Tunnel**, **DevTunnel-CLI**, **devtunnel-cli**, **dev-tunnel-cli**, **Dev-Tunnel-CLI**. npm (install here): [devtunnel-cli](https://www.npmjs.com/package/devtunnel-cli) ยท Docs: [devtunnel-cli.vercel.app](https://devtunnel-cli.vercel.app) ยท GitHub: [maiz-an/DevTunnel-CLI](https://github.com/maiz-an/DevTunnel-CLI).
|
|
118
217
|
|
|
119
218
|
---
|
|
120
219
|
|
|
121
220
|
## ๐ฆ Links
|
|
122
221
|
|
|
123
|
-
- **Website**: [
|
|
222
|
+
- **Website**: [devtunnel-cli.vercel.app](https://devtunnel-cli.vercel.app)
|
|
124
223
|
- **npm**: [devtunnel-cli](https://www.npmjs.com/package/devtunnel-cli)
|
|
125
224
|
- **GitHub**: [maiz-an/DevTunnel-CLI](https://github.com/maiz-an/DevTunnel-CLI)
|
|
126
225
|
- **Issues**: [GitHub Issues](https://github.com/maiz-an/DevTunnel-CLI/issues)
|
package/package.json
CHANGED
|
@@ -1,8 +1,8 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "devtunnel-cli",
|
|
3
|
-
"version": "3.0.
|
|
3
|
+
"version": "3.0.37",
|
|
4
4
|
"type": "module",
|
|
5
|
-
"description": "DevTunnel-CLI (DevTunnel, devtunnel, dev-tunnel) -
|
|
5
|
+
"description": "DevTunnel-CLI (DevTunnel, devtunnel, dev-tunnel) - Development tool for sharing local servers worldwide. Zero config, supports multiple ports. For dev, testing, demos, webhook debugging. Not for production. npm install -g devtunnel-cli. Works with Vite, React, Laravel, HTML, PHP/XAMPP.",
|
|
6
6
|
"main": "src/core/start.js",
|
|
7
7
|
"files": [
|
|
8
8
|
"README.md",
|
|
@@ -69,7 +69,7 @@
|
|
|
69
69
|
"bugs": {
|
|
70
70
|
"url": "https://github.com/maiz-an/DevTunnel-CLI/issues"
|
|
71
71
|
},
|
|
72
|
-
"homepage": "https://
|
|
72
|
+
"homepage": "https://devtunnel-cli.vercel.app",
|
|
73
73
|
"engines": {
|
|
74
74
|
"node": ">=16.0.0"
|
|
75
75
|
},
|