sails

API-driven framework for building realtime apps, using MVC conventions (based on Express and Socket.io)

MIT 240 个版本

mvc web-framework express sailsjs sails.js REST API orm socket.io

主页

仓库

提交 Issue

安装

npm install sails

yarn add sails

pnpm add sails

bun add sails

README

Website Get Started Docs News Submit Issue

Sails.js is a web framework that makes it easy to build custom, enterprise-grade Node.js apps. It is designed to resemble the MVC architecture from frameworks like Ruby on Rails, but with support for the more modern, data-oriented style of web app & API development. It's especially good for building realtime features like chat.

Since version 1.0, Sails supports await out of the box. This replaces nested callbacks (and the commensurate error handling) with simple, familiar usage:

var orgs = await Organization.find();

Installation

With node installed:

# Get the latest stable release of Sails
$ npm install sails -g

Upgrading from an earlier version of Sails?

Upgrade guides for all major releases since 2013 are available on the Sails website under Upgrading.

Your First Sails Project

Create a new app:

# Create the app
sails new my-app

Lift sails:

# cd into the new folder
cd my-app

# fire up the server
sails lift

For the most up-to-date introduction to Sails, get started here.

Compatibility

Sails is built on Node.js, Express, and Socket.io.

Sails actions are compatible with Connect middleware, so in most cases, you can paste code into Sails from an existing Express project and everything will work-- plus you'll be able to use WebSockets to talk to your API, and vice versa.

The ORM, Waterline, has a well-defined adapter system for supporting all kinds of datastores. Officially supported databases include MySQL, PostgreSQL, MongoDB, Redis, and local disk / memory. Community adapters exist for CouchDB, neDB, SQLite, Oracle, MSSQL, DB2, ElasticSearch, Riak, neo4j, OrientDB, Amazon RDS, DynamoDB, Azure Tables, RethinkDB and Solr; for various 3rd-party REST APIs like Quickbooks, Yelp, and Twitter, including a configurable generic REST API adapter; plus some eclectic projects.

For the latest core adapters and notable community adapters, see Available Adapters.

Tutorial Course

Sailscasts, taught by Kelvin Omereshone (English)
Full-Stack JavaScript with Sails.js and Vue.js, taught by Mike McNeil (in English, with optional Spanish subtitles)

Books

Sails.js in Action by Mike McNeil and Irl Nathan (Manning Publications).
Sails.js Essentials by Shaikh Shahid (Packt)
Pro Express.js: Part 3 by Azat Mardan (Apress).

Support

Need help or have a question?

Issue submission

Please read the submission guidelines and code of conduct before opening a new issue. Click here to search/post issues in this repository.

Contribute

There are many different ways you can contribute to Sails:

answering questions on StackOverflow, Gitter, Facebook, or Twitter
improving the documentation
translating the documentation to your native language
writing tests
writing a tutorial, giving a talk, or supporting your local Sails meetup
troubleshooting reported issues
and submitting patches.

Please carefully read our contribution guide and check the build status for the relevant branch before submitting a pull request with code changes.

Team

Sails is actively maintained with the help of many amazing contributors. Our core team consists of:


Mike McNeil	Kelvin Omereshone	Eric Shaw

Our company designs/builds Node.js websites and apps for startups and enterprise customers. After building a few applications and taking them into production, we realized that the Node.js development landscape was very much still the Wild West. Over time, after trying lots of different methodologies, we decided to crystallize all of our best practices into this framework. Six years later, Sails is now one of the most widely-used web application frameworks in the world. I hope it saves you some time! :)

License

Sails is built around so many great open-source technologies that it would never have crossed our minds to keep it proprietary. We owe huge gratitude and props to Ryan Dahl (@ry), TJ Holowaychuk (@tj), Doug Wilson (@dougwilson) and Guillermo Rauch (@rauchg) for the work they've done, as well as the stewards of all the other open-source modules we use. Sails could never have been developed without your tremendous contributions to the JavaScript community.

A squid peering inside a book, halation and cosmic Sails.js knowledge emanating from the pages of the substantial tome

版本列表

1.5.18 2026-05-27

1.5.17 2026-02-17

1.5.16 2026-02-02

1.5.15 2025-08-06

1.5.14 2024-12-06

1.5.13 2024-11-08

1.5.12 2024-09-17

1.5.11 2024-05-17

1.5.10 2024-04-09

1.5.9 2024-01-04

1.5.8 2023-09-01

1.5.7 2023-07-21

1.5.6 2023-07-07

1.5.5 2023-06-23

1.5.4 2023-02-17

1.5.3 2022-08-11

1.5.2 2022-01-14

1.5.1 2022-01-10

1.5.0 2021-09-16

1.4.4 2021-07-27

1.4.3 2021-05-17

1.4.2 2021-03-10

1.4.1 2021-03-10

1.4.0 2020-10-09

1.3.1 2020-09-08

1.3.0 2020-09-02

1.2.5 2020-08-20

1.2.4 2020-03-19

1.2.3 2019-06-18

1.2.2 2019-05-16

1.2.1 2019-05-06

1.2.0-3 2019-03-25

1.2.0-2 2019-01-31

1.2.0-1 2019-01-31

1.2.0-0 2019-01-16

1.1.0-3 2018-08-24

1.1.0-2 2018-08-02

1.1.0-1 2018-08-02

1.1.0 2018-11-13

1.0.3-4 2018-07-23

1.0.3-3 2018-07-23

1.0.3-2 2018-05-29

1.0.3-1 2018-05-29

1.0.3-0 2018-05-28

1.0.2 2018-05-06

1.0.1 2018-04-07

1.0.0-49 2018-03-26

1.0.0-48 2018-03-26

1.0.0-47 2018-03-23

1.0.0-46 2018-01-31

1.0.0-45 2017-12-21

1.0.0-44 2017-12-20

1.0.0-42 2017-12-09

1.0.0-41 2017-11-21

1.0.0-40 2017-11-05

1.0.0-39 2017-11-03

1.0.0-38 2017-10-18

1.0.0-37 2017-08-21

1.0.0-36 2017-05-31

1.0.0-35 2017-05-24

1.0.0-34 2017-04-29

1.0.0-33 2017-04-05

1.0.0-32 2017-03-21

1.0.0-31 2017-03-16

1.0.0-30 2017-03-06

1.0.0-29 2017-03-04

1.0.0-28 2017-03-02

1.0.0-27 2017-02-24

1.0.0-26 2017-02-24

1.0.0-25 2017-02-23

1.0.0-24 2017-02-22

1.0.0-23 2017-02-21

1.0.0-22 2017-02-03

1.0.0-21 2017-02-03

1.0.0-20 2017-01-09

1.0.0-19 2016-12-31

1.0.0-18 2016-12-08

1.0.0-17 2016-12-06

1.0.0-16 2016-12-02

1.0.0-15 2016-11-29

1.0.0-14 2016-11-21

1.0.0-13 2016-11-17

1.0.0-12 2016-11-16

1.0.0-11 2016-11-07

1.0.0-10 2016-11-04

1.0.0-9 2016-11-04

1.0.0-8 2016-10-27

1.0.0-7 2016-10-27

1.0.0-6 2016-10-27

1.0.0-5 2016-09-28

1.0.0-4 2016-09-28

1.0.0-3 2016-09-23

1.0.0-2 2016-09-19

1.0.0-1 2016-09-18

1.0.0-0 2016-09-15

1.0.0 2018-03-28

0.12.14 2017-09-25

0.12.13 2017-03-06

0.12.12-3 2017-03-02

0.12.12-2 2017-03-02

0.12.12-1 2017-01-16

0.12.12 2017-03-02

0.12.11-1 2016-11-22

0.12.11-0 2016-11-19

0.12.11 2016-11-24

0.12.10-1 2016-11-16

0.12.10-0 2016-11-16

0.12.10 2016-11-16

0.12.9 2016-11-02

0.12.8 2016-10-21

0.12.7 2016-10-05

0.12.6 2016-09-28

0.12.5 2016-09-27

0.12.4 2016-08-01

0.12.4-rc3 2016-07-29

0.12.4-rc2 2016-07-08

0.12.4-rc1 2016-07-05

0.12.3 2016-04-04

0.12.2-0 2016-04-01

0.12.2 2016-04-02

0.12.1 2016-02-15

0.12.1-rc1 2016-02-12

0.12.1-deprecatedDepExperiment 2016-03-12

0.12.0 2016-02-05

0.12.0-rc9 2016-02-02

0.12.0-rc8 2016-01-25

0.12.0-rc7 2016-01-21

0.12.0-rc6 2016-01-13

0.12.0-rc5 2016-01-13

0.12.0-rc4 2015-12-18

0.12.0-rc3 2015-07-14

0.12.0-rc2 2015-06-19

0.12.0-rc1 2015-05-18

0.11.6-1 2016-06-20

0.11.6-0 2016-06-20

0.11.5 2016-02-05

0.11.4 2016-01-06

0.11.3 2015-11-23

0.11.2 2015-09-23

0.11.1 2015-04-07

0.11.1-rc1 2015-04-27

0.11.0 2015-02-11

0.11.0-rc9 2015-01-26

0.11.0-rc8 2015-01-20

0.11.0-rc7 2015-01-20

0.11.0-rc6 2015-01-19

0.11.0-rc5 2014-12-31

0.11.0-rc4 2014-12-23

0.11.0-rc3 2014-12-21

0.11.0-rc2 2014-12-19

0.11.0-rc10 2015-02-03

0.10.5 2014-08-29

0.10.4 2014-08-12

0.10.3 2014-08-10

0.10.2 2014-08-06

0.10.1 2014-08-02

0.10.0-rc9 2014-07-17

0.10.0-rc8 2014-06-11

0.10.0-rc7 2014-05-08

0.10.0-rc6 2014-05-06

0.10.0-rc5 2014-04-01

0.10.0-rc4 2014-03-04

0.10.0-rc3 2014-02-20

0.10.0-rc2 2014-02-20

0.10.0-rc11 2014-07-28

0.10.0-rc10 2014-07-25

0.10.0-rc1 2014-02-17

0.10.0-max 2014-07-25

0.9.17 2014-07-15

0.9.16 2014-03-31

0.9.15 2014-03-25

0.9.13 2014-03-12

0.9.12 2014-03-12

0.9.11 2014-03-01

0.9.9 2014-02-14

0.9.8 2013-12-16

0.9.7 2013-10-10

0.9.5 2013-10-10

0.9.4 2013-09-05

0.9.3 2013-07-19

0.9.2 2013-07-19

0.9.1 2013-07-18

0.9.0 2013-07-18

0.8.895 2013-03-18

0.8.894 2013-03-16

0.8.892 2013-03-15

0.8.94 2013-06-30

0.8.93 2013-06-22

0.8.92 2013-06-22

0.8.91 2013-05-16

0.8.89-1 2013-03-07

0.8.89 2013-03-06

0.8.88 2013-03-05

0.8.87 2013-03-05

0.8.86 2013-03-04

0.8.85 2013-03-03

0.8.84 2013-03-03

0.8.83 2013-03-03

0.8.82 2013-02-25

0.8.81 2013-02-25

0.8.80 2013-02-23

0.8.79 2013-02-23

0.8.78 2013-02-23

0.8.77 2013-02-22

0.8.76 2013-02-21

0.8.75 2013-02-21

0.8.74 2013-02-21

0.8.73 2013-02-21

0.8.72 2013-02-21

0.8.71 2013-02-21

0.8.9 2013-04-09

0.8.7 2013-02-20

0.8.6 2013-02-20

0.8.5 2013-02-18

0.8.4 2013-02-18

0.8.3 2013-02-17

0.8.2 2013-02-17

0.8.1 2013-02-15

0.8.0 2013-02-15

0.7.9 2013-02-14

0.7.8 2013-02-11

0.7.7 2013-02-11

0.7.6-0 2013-02-07

0.7.5-0 2013-02-05

0.7.4-1 2013-02-01

0.7.4 2013-01-31

0.7.3 2013-01-31

0.7.2 2013-01-30

0.7.1 2013-01-30

0.7.0-8 2013-01-30

0.7.0-7 2013-01-28

0.7.0-6 2013-01-23

0.7.0-5 2013-01-19

0.7.0-4 2013-01-19

0.7.0-3 2013-01-16

0.7.0-2 2013-01-16

0.7.0 2013-01-16

0.0.0-2 2013-01-16

0.0.0-1 2013-01-23

0.0.0 2013-01-16