Εγκατάσταση
Προσθέστε το Doconut στο .NET 8 έργο σας
Ο βασικός προβολέας Doconut για .NET 8 διανέμεται ως ένα πακέτο NuGet που ενσωματώνεται σε οποιαδήποτε εφαρμογή ASP.NET Core. Προαιρετικά πρόσθετα χρησιμοποιούν ξεχωριστά πακέτα. Αυτή η σελίδα εγκαθιστά το βασικό πακέτο και καταχωρίζει το middleware — το ελάχιστο που απαιτείται πριν από την πρώτη σας απόδοση.
Απαιτήσεις
Το πακέτο λειτουργεί σε αυτές τις πλατφόρμες:
| Πλατφόρμα | Υποστηρίζεται |
|---|---|
| Windows x64 / x86 | Ναι |
Linux x64, glibc-based (Debian, Ubuntu, the official mcr.microsoft.com/dotnet/aspnet:8.0 image) | Ναι |
| Alpine και άλλες διανομές βασισμένες σε musl | Όχι |
| macOS | Όχι |
Στο Linux, εγκαταστήστε τη βιβλιοθήκη ρύθμισης γραμματοσειρών πριν ανοίξει το πρώτο έγγραφο:
apt-get update && apt-get install -y libfontconfig1Σε διανομές RHEL, Fedora και παρόμοιες, το πακέτο είναι fontconfig (dnf install -y fontconfig). Αυτό είναι το μόνο σύστημα πακέτο που χρειάζεται το Doconut: οι εγγενείς βιβλιοθήκες που χρησιμοποιεί περιλαμβάνονται μέσα στο πακέτο NuGet, και το libgdiplus δεν απαιτείται. Οι σελίδες σχεδιάζονται με τις γραμματοσειρές που είναι εγκατεστημένες στον διακομιστή, οπότε δείτε Αντιμετώπιση προβλημάτων για τις γραμματοσειρές και τα μηνύματα σφάλματος του Linux.
Εγκατάσταση πακέτου
dotnet add package Doconut.NET8Η εντολή χωρίς έκδοση εγκαθιστά την πιο πρόσφατη σταθερή έκδοση. Για να κλειδώσετε την έκδοση που περιγράφει αυτή η τεκμηρίωση, περάστε την έκδοση ως ξεχωριστή επιλογή:
dotnet add package Doconut.NET8 --version 26.10.0Doconut.NET8 είναι το αναγνωριστικό του πακέτου. Το επίθημα έκδοσης ανήκει στο ληφθέν όνομα αρχείου Doconut.NET8.<version>.nupkg και δεν αποτελεί μέρος του αναγνωριστικού.
Καταχώρηση Doconut
AddDoconut() είναι το μοναδικό σημείο εγγραφής — υπάρχει μία μόνο υπερφόρτωση, και συνδέει την υπηρεσία Viewer, την υπηρεσία άδειας, και την υποδομή απόδοσης στο DI container.
Δύο κλήσεις middleware ολοκληρώνουν τη ρύθμιση, και η σειρά τους έχει σημασία: UseDoconutResources() πρέπει να εκτελείται πριν από UseDoconut(). UseDoconut() είναι τελικό middleware, έτσι η κλήση του πρώτα σημαίνει ότι κάθε αίτημα σε έναν πόρο /doconut-res δεν φτάνει ποτέ στον διαχειριστή πόρων και επιστρέφει 404. UseDoconut() απαντά σε κάθε αίτημα που το φθάνει, οπότε τοποθετήστε το σε ξεχωριστό κλάδο με app.Map. Η σύνδεση της συνεδρίας απαιτείται επίσης — η προεπιλεγμένη ασφάλεια εγγράφου του Doconut επικυρώνει κάθε αίτημα σελίδας έναντι της κατάστασης συνεδρίας ASP.NET.
builder.Services.AddDoconut(options =>
{
options.LicensePath = "Doconut.Viewer.lic";
});
builder.Services.AddDistributedMemoryCache(); // η κατάσταση της συνεδρίας χρειάζεται μια κρυφή μνήμη (MVC/Razor Pages ήδη προσθέτουν μία)
builder.Services.AddSession(); // Η ασφάλεια εγγράφου Doconut βασίζεται στην κατάσταση συνεδρίας ASP.NET
app.UseSession(); // καλέστε το UseSession() πριν το UseDoconut()
app.UseDoconutResources(); // πρέπει να εγγραφεί πριν το UseDoconut()
app.Map("/doconut", branch => branch.UseDoconut());Όλες οι επιλογές
DoconutOptions δέχεται τις ακόλουθες ρυθμιζόμενες ιδιότητες. Κάθε μία είναι προαιρετική — οι προεπιλογές παρακάτω ισχύουν όταν μια ιδιότητα παραμείνει ακαθορισμένη.
| Ιδιότητα | Προεπιλογή | Περιγραφή |
|---|---|---|
ShowDoconutInfo | false | Όταν true, ένα αίτημα χωρίς token επιστρέφει μια μπάνερ έκδοσης αντί για 404. Χρήσιμο ως έλεγχος καπνού· απενεργοποιήστε το στην παραγωγή. |
UnsafeMode | false | Όταν true, παραλείπει τον έλεγχο ασφαλείας συνεδρίας ASP.NET στα αιτήματα σελίδας. Απενεργοποιήστε το στην παραγωγή. |
MiddlewarePath | "/doconut" | Τιμή συντονισμού για το endpoint page-image. Επικυρώνεται, αλλά δεν δημιουργεί κλάδο από μόνη της· διατηρήστε την ευθυγραμμισμένη με την πραγματική αντιστοίχιση UseDoconut() και τον πελάτη BasePath. |
ResourcesPath | "/doconut-res" | Από πού σερβίρονται οι ενσωματωμένοι πόροι JS/CSS/εικόνας. |
LicensePath | "" (κενή συμβολοσειρά) | Διαδρομή προς το αρχείο άδειας. Κενό σημαίνει μετάβαση στην επόμενη πηγή, μετά αυτόματη αναζήτηση. |
LicenseContent | "" (κενή συμβολοσειρά) | Ακατέργαστο περιεχόμενο άδειας — από μεταβλητή περιβάλλοντος, διαχειριστή μυστικών ή βάση δεδομένων. |
LicenseStream | null | Άδεια ως ροή, διαβάζεται μία φορά κατά την εκκίνηση. |
ResetLicense | false | Δεσμευμένη σημαία συμβατότητας. Οι τρέχουσες υπηρεσίες .NET 8 διαβάζουν την άδεια κατά τη διάρκεια AddDoconut()· επανεκκινήστε την εφαρμογή μετά την αντικατάσταση μιας άδειας. |
MaxConcurrentEditorSessions | 200 | Μέγιστος αριθμός ενεργών συνεδριών επεξεργαστή (έγγραφα ανοιχτά με DocOptions.EditMode). Πάνω από αυτό, η λιγότερο πρόσφατα χρησιμοποιημένη αδρανής συνεδρία επεξεργαστή κλείνει. Οι κανονικές συνεδρίες προβολέα δεν μετρώνται. 0 ή μια αρνητική τιμή σημαίνει χωρίς όριο. |
EditorSnapshotEveryOps | 50 | Με την ενεργοποίηση της διατήρησης επεξεργαστή (AddDoconutEditorPersistence), δημιουργήστε στιγμιότυπο του ενεργού εγγράφου κάθε N καταγεγραμμένες αλλαγές. 0 ή μια αρνητική τιμή δεν δημιουργεί στιγμιότυπα κατά τη διάρκεια της συνεδρίας. Δεν έχει επίδραση όταν η διατήρηση είναι απενεργοποιημένη. |
Προτεραιότητα άδειας όταν ορίζονται περισσότερες από μία πηγές: LicenseStream υπερισχύει του LicenseContent, που υπερισχύει του LicensePath, που υπερισχύει της αυτόματης αναζήτησης — δείτε Ρύθμιση Άδειας.
builder.Services.AddDoconut(options =>
{
options.LicensePath = "Doconut.Viewer.lic";
options.MiddlewarePath = "/doconut"; // συντονίστε με τη χαρτογράφηση της εφαρμογής και το BasePath του πελάτη
options.ResourcesPath = "/doconut-res"; // από πού εξυπηρετούνται τα JS/CSS/εικόνες του viewer
options.UnsafeMode = false; // διατηρήστε ενεργή την ασφάλεια της συνεδρίας
options.ShowDoconutInfo = false;
});Επόμενα βήματα
- Γρήγορη Εκκίνηση — ανοίξτε το πρώτο σας έγγραφο και εμφανίστε το στον περιηγητή.
- Ρύθμιση Άδειας — όπου το Doconut αναζητά το αρχείο άδειας σας.
Ήταν αυτή η σελίδα χρήσιμη;