// Package rc implements a remote control server and registry for rclone // // To register your internal calls, call rc.Add(path, function). Your // function should take ane return a Param. It can also return an // error. Use rc.NewError to wrap an existing error along with an // http response type if another response other than 500 internal // error is required on error. package rc import ( "encoding/json" "io" "net/http" _ "net/http/pprof" // install the pprof http handlers "strings" "github.com/ncw/rclone/cmd/serve/httplib" "github.com/ncw/rclone/fs" "github.com/pkg/errors" ) // Options contains options for the remote control server type Options struct { HTTPOptions httplib.Options Enabled bool } // DefaultOpt is the default values used for Options var DefaultOpt = Options{ HTTPOptions: httplib.DefaultOpt, Enabled: false, } func init() { DefaultOpt.HTTPOptions.ListenAddr = "localhost:5572" } // Start the remote control server if configured func Start(opt *Options) { if opt.Enabled { s := newServer(opt) go s.serve() } } // server contains everything to run the server type server struct { srv *httplib.Server } func newServer(opt *Options) *server { // Serve on the DefaultServeMux so can have global registrations appear mux := http.DefaultServeMux s := &server{ srv: httplib.NewServer(mux, &opt.HTTPOptions), } mux.HandleFunc("/", s.handler) return s } // serve runs the http server - doesn't return func (s *server) serve() { err := s.srv.Serve() if err != nil { fs.Errorf(nil, "Opening listener: %v", err) } fs.Logf(nil, "Serving remote control on %s", s.srv.URL()) s.srv.Wait() } // WriteJSON writes JSON in out to w func WriteJSON(w io.Writer, out Params) error { enc := json.NewEncoder(w) enc.SetIndent("", "\t") return enc.Encode(out) } // handler reads incoming requests and dispatches them func (s *server) handler(w http.ResponseWriter, r *http.Request) { path := strings.Trim(r.URL.Path, "/") in := make(Params) writeError := func(err error, status int) { fs.Errorf(nil, "rc: %q: error: %v", path, err) w.WriteHeader(status) err = WriteJSON(w, Params{ "error": err.Error(), "input": in, }) if err != nil { // can't return the error at this point fs.Errorf(nil, "rc: failed to write JSON output: %v", err) } } // Parse the POST and URL parameters into r.Form, for others r.Form will be empty value err := r.ParseForm() if err != nil { writeError(errors.Wrap(err, "failed to parse form/URL parameters"), http.StatusBadRequest) return } // Read the POST and URL parameters into in for k, vs := range r.Form { if len(vs) > 0 { in[k] = vs[len(vs)-1] } } // Parse a JSON blob from the input if r.Header.Get("Content-Type") == "application/json" { err := json.NewDecoder(r.Body).Decode(&in) if err != nil { writeError(errors.Wrap(err, "failed to read input JSON"), http.StatusBadRequest) return } } w.Header().Add("Access-Control-Allow-Origin", "*") //echo back headers client needs reqAccessHeaders := r.Header.Get("Access-Control-Request-Headers") w.Header().Add("Access-Control-Allow-Headers", reqAccessHeaders) switch r.Method { case "POST": s.handlePost(w, r, path, in) case "OPTIONS": s.handleOptions(w, r, in) default: writeError(errors.Errorf("method %q not allowed - POST or OPTIONS required", r.Method), http.StatusMethodNotAllowed) return } } func (s *server) handlePost(w http.ResponseWriter, r *http.Request, path string, in Params) { writeError := func(err error, status int) { fs.Errorf(nil, "rc: %q: error: %v", path, err) // Adjust the error return for some well known errors switch errors.Cause(err) { case fs.ErrorDirNotFound, fs.ErrorObjectNotFound: status = http.StatusNotFound } w.WriteHeader(status) err = WriteJSON(w, Params{ "error": err.Error(), "input": in, }) if err != nil { // can't return the error at this point fs.Errorf(nil, "rc: failed to write JSON output: %v", err) } } // Find the call call := registry.get(path) if call == nil { writeError(errors.Errorf("couldn't find method %q", path), http.StatusMethodNotAllowed) return } // Check to see if it is async or not isAsync, err := in.GetBool("_async") if err != nil { writeError(err, http.StatusBadRequest) return } fs.Debugf(nil, "rc: %q: with parameters %+v", path, in) var out Params if isAsync { out, err = StartJob(call.Fn, in) } else { out, err = call.Fn(in) } if err != nil { writeError(err, http.StatusInternalServerError) return } if out == nil { out = make(Params) } fs.Debugf(nil, "rc: %q: reply %+v: %v", path, out, err) err = WriteJSON(w, out) if err != nil { // can't return the error at this point fs.Errorf(nil, "rc: failed to write JSON output: %v", err) } } func (s *server) handleOptions(w http.ResponseWriter, r *http.Request, in Params) { w.WriteHeader(http.StatusOK) }