b9f2bb255d
In general, we try to avoid allowing TCP connections to be open with no traffic on it indefinitely. We place timeouts on incoming HTTP connections in webapp_server.js (which we adjust to longer values when there's an HTTP request pending), and once a DDP connection is fully established we require heartbeats. However, if the incoming connection is a websocket, the faye-websocket package used by SockJS calls setTimeout(0) on the underlying socket when it initializes the WebSocket object: https://github.com/faye/faye-websocket-node/blob/3148348a3/lib/faye/websocket/api.js#L111 So if a client does the WebSocket handshake with the server but never sends a valid DDP connect message, the socket can be held open indefinitely. (To add insult to injury, a 1MB Buffer object is retained on such sockets due to something in the faye-websocket code, at least on older versions of Node like 0.10.) This commit restores a timeout on the socket for this in-between period. (We actually saw this issue in production on the Meteor Developer Accounts server --- hundreds of such broken connections would accumulate over time. This may be triggered by a particular setup we use involving proxies for the accounts server, or it may be a more generally applicable issue.)
Meteor
Meteor is an ultra-simple environment for building modern web applications.
With Meteor you write apps:
- in pure JavaScript
- that send data over the wire, rather than HTML
- using your choice of popular open-source libraries
Try the getting started tutorial.
Next, read the guide or the reference documentation at http://docs.meteor.com/.
Quick Start
On Windows, simply go to https://www.meteor.com/install and use the Windows installer.
On Linux/macOS, use this line:
curl https://install.meteor.com/ | sh
Create a project:
meteor create try-meteor
Run it:
cd try-meteor
meteor
Slow Start (for developers)
If you want to run on the bleeding edge, or help contribute to Meteor, you can run Meteor directly from a Git checkout using these steps:
-
Clone from GitHub
$ git clone --recursive https://github.com/meteor/meteor.git $ cd meteorImportant note about Git submodules!
This repository uses Git submodules. If you clone without the
--recursiveflag, re-fetch withgit pullor experience "Depending on unknown package" errors, run the following in the repository root to sync things up again:$ git submodule update --init --recursive -
(Optional) Compile dependencies
This optional step requires a C and C++ compiler, autotools, and scons. If this step is skipped, Meteor will simply download pre-built binaries.
To build everything from scratch (
node,npm,mongodb, etc.) run the following:$ ./scripts/generate-dev-bundle.sh # OPTIONAL! -
Run a Meteor command to install dependencies
If you did not compile dependencies above, this will also download the binaries.
$ ./meteor --help -
Ready to Go!
Your local Meteor checkout is now ready to use! You can use this
./meteoranywhere you would normally call the systemmeteor. For example,:$ cd my-app/ $ /path/to/meteor-checkout/meteor runNote: When running from a
gitcheckout, you cannot pin apps to specific Meteor releases or change the release using--release.
Uninstalling Meteor
Aside from a short launcher shell script, Meteor installs itself inside your home directory. To uninstall Meteor, run:
rm -rf ~/.meteor/
sudo rm /usr/local/bin/meteor
On Windows, just run the uninstaller from your Control Panel.
Developer Resources
Building an application with Meteor?
- Announcement list: sign up at http://www.meteor.com/
- Having problems? Ask for help at: http://stackoverflow.com/questions/tagged/meteor
- Discussion forums: https://forums.meteor.com/
Interested in contributing to Meteor?
- Issue tracker: https://github.com/meteor/meteor/issues
- Contribution guidelines: https://github.com/meteor/meteor/tree/devel/Contributing.md
We are hiring! Visit https://www.meteor.com/jobs to learn more about working full-time on the Meteor project.